Перейти к основному содержимому

Global eSIM

Global eSIM gives an extension a mobile number that works in several countries. MonoPbx sells partner eSIMs with a data allowance; the phone with the eSIM registers by VoLTE to this MonoPbx, so the extension rings the handset and the handset's calls and SMS come from the extension, wherever the phone roams. It needs no radio network or packet core of your own: for that, see Private 4/5G.

Find it in the admin console under Numbers and trunks, Global eSIM. The entry appears in the sidebar once this server is signed in to a licence account or has SIMs; until then open /admin/gesim or find it with Ctrl K. The pages need the permission to view system settings; buying and changing SIMs need the permission to change them.

How it works​

  • The eSIMs belong to a partner network. Mobile data breaks out at our partner, near the user.
  • VoLTE registrations go to this MonoPbx. Authentication uses vectors that the partner core hands to your PBX one registration at a time. The SIM's keys never reach your PBX, so a PBX can only serve the SIMs that were sold to it.
  • One allowance is shared by IMS and mobile data: calls, SMS and data all spend the same bundle.
  • You can turn mobile data off per SIM. Calls and SMS keep working and keep spending the same allowance.
  • VoWiFi (Wi-Fi calling) is not available with these SIMs.
  • Emergency calls are not routed to the PBX. The phone and the visited network handle them, so never rely on the eSIM for emergency calling.
  • Each offer lists the countries it works in. Outside them the allowance does not work.

Requirements​

  1. A public IP address. The phone reaches your PBX over the internet and IMS IPsec does not cross NAT, so the host that runs the P-CSCF role needs a routable public address (the console shows the one it found from your SIP domain and lets you set another).
  2. Open ports to the partner's published source ranges: UDP and TCP 5060 for SIP, ESP (IP protocol 50) for IPsec and the media (RTP) port range of the PBX. The ranges are listed under IMS address.
  3. The P-CSCF role running (mpbx --role pcscf) on the host with that IP address, and IMS mode switched on (it is on by default). See Private 4/5G for the P-CSCF role.
  4. A licence account with a payment method. Sign in on the Licence page; the card on file is the one that is charged (Licence account sign-in and payment methods).

The Overview page ticks these off: licence account, card on file, public IP and the token of the authentication gateway. The licence server issues that token and your PBX renews it by itself; an operator can also provision it with MPBX_IMS_GESIM_AV_TOKEN. Until it is available, Global eSIM registrations are refused.

Buying a pack​

Open Buy. First choose the country (an offering): the page shows its mobile country codes and its bundles with their monthly prices. Then choose a pack: its number of SIMs and its upfront fee, which is the only charge of the pack. Prices, countries and bundles come from the licence server; nothing is fixed in the PBX.

Choose Buy: a confirmation shows the upfront total and the card that will be charged, and says that bundles are charged monthly, per SIM, when you activate them. Confirm, and the card is charged at once. The order then shows its progress under Orders (the SIMs are being built, then delivered) and the SIMs appear under SIMs. The PBX reports its public IP address with the order.

If the purchase is refused, the console says why: no card on file, the card was declined (not supported, insufficient funds, expired), the PBX is not signed in to a licence account, or no public IP address is known.

Bundles and SIMs​

Under SIMs each eSIM shows its ICCID, IMSI, number, status (being built, ready, active, ending with the paid period, suspended or cancelled), the country and registration seen by the network (a dash when not reported), bundle, remaining allowance, mobile data switch and extension.

  • Choose a bundle. A new SIM has no allowance until you activate a bundle. The list shows the bundles of the SIM's own country with their monthly price (for example 100, 200 or 500 MB per month). The choice is made once and cannot be changed for now. The first month is charged when you confirm, and the bundle renews every month, one subscription per SIM, until you cancel it. A failed monthly payment suspends the line; it resumes when the payment goes through.
  • Cancel a bundle. This stops the renewal. There is no refund: the paid period and its allowance run to their end, and the SIM shows that its renewal is cancelled and ends with the paid period. The confirmation says so first.
  • Allowance. Refresh reads how much is used and left from the core on demand.
  • Mobile data. The switch turns data off or on. The phone re-attaches by itself within minutes.
  • Install the eSIM. Open the row's ... menu and choose Show QR code to display the activation QR code in a window; scan it on the phone (Settings, mobile network, add eSIM). The LPA activation text is shown with it.

Attach a SIM to an extension​

Open the SIM's ... menu, choose Attach to extension, pick an extension in the window and choose Attach. This creates the SIM's IMS subscriber on that extension (VoLTE only, IPsec required, no keys). When the phone registers, the extension rings it, and calls and SMS from the handset come from the extension. Detach (same menu) removes the subscriber; the SIM and its bundle stay. A Global eSIM cannot be created by hand in IMS subscribers: its identity belongs to the partner.

Once attached, the extension's user sees the eSIM under My eSIMs in the MonoPhone app with its countries, the data left and when it was last seen, can turn mobile data off and on for it themselves (calls and messages keep working and use the same allowance), and can get its activation once to install it (see My eSIMs). To send them the install link, to let them install it again, or to stop it, use eSIM assignments (see eSIM packs).

The IMS address and the firewall​

Under IMS address you can see the address in use, the one found from the SIP domain, and set another address and extra CIDRs the SIMs may reach on the IMS connection. The address must be a public IP address: private, shared (CGNAT), documentation and reserved ranges are refused. Saving tells the licence server for every SIM; the phones re-attach by themselves within minutes to pick up the new address.

The page also lists the partner's source ranges for your firewall allow-list and the checklist: SIP 5060, ESP, the media range and the P-CSCF role.