Megosztás a következőn keresztül:

Integrálás az Azure Communications Gateway Kiépítési API-jával (előzetes verzió)

  • Cikk

Ez a cikk azt ismerteti, hogy mikor kell integrálnia az Azure Communications Gateway Kiépítési API-jával (előzetes verzió), és magas szintű áttekintést nyújt az első lépésekről. Távközlési operátorok számára készült szoftverfejlesztőknek készült.

A Kiépítési API-val konfigurálhatja az Azure Communications Gatewayt az ügyfelek adataival és a hozzájuk rendelt számokkal. Ha a Kiépítési API-t használja a háttérszolgáltatás-szinkronizáláshoz, a Szolgáltatói kapcsolat és a Teams Telefon Mobile-környezeteket is kiépítheti a vállalati ügyfelek adataival és a hozzájuk rendelt számokkal. Ez a folyamatalapú kiépítés lehetővé teszi, hogy megfeleljen a Szolgáltatói kapcsolat és a Teams Telefon Mobile azon követelményének, hogy API-k segítségével kezelje az ügyfeleket és a számokat a szolgáltatás elindítása után.

A Kiépítési API egy REST API.

Az, hogy integrálódik-e a Provisioning API-val, a választott kommunikációs szolgáltatástól függ.

Kommunikációs szolgáltatás API-integráció kiépítése Cél
Közvetlen Microsoft Teams-útválasztás Támogatott (a Számkezelési portál alternatívaként) – Az egyes közvetlen útválasztási ügyfelekhez társított altartomány konfigurálása.
- Az egyes ügyfelekre vonatkozó DNS-rekordok létrehozása (a Microsoft 365-környezetnek megfelelően).
– Azt jelzi, hogy a számok engedélyezve vannak a közvetlen útválasztáshoz.
- (Nem kötelező) Egyéni fejléc konfigurálása a hálózatba irányuló üzenetekhez.
Szolgáltatói kapcsolat Ajánlott - (Ajánlott) Az Szolgáltatói kapcsolat ügyfelek folyamatalapú kiépítése Szolgáltatói kapcsolat API-kkal való együttműködésen keresztül (háttérszolgáltatás-szinkronizálás használatával).
- (Nem kötelező) Egyéni fejléc konfigurálása a hálózatba irányuló üzenetekhez.
Teams Telefon Mobile Ajánlott - (Ajánlott) A Teams Telefon Mobile-ügyfelek folyamatalapú kiépítése Szolgáltatói kapcsolat API-kkal való együttműködésen keresztül (háttérszolgáltatás-szinkronizálás használatával).
Felhőalapú társviszony-létesítés nagyítása Telefon Támogatott (a Számkezelési portál alternatívaként) - Azt jelzi, hogy a számok engedélyezve vannak a nagyításhoz.
- (Nem kötelező) Egyéni fejléc konfigurálása a hálózatba irányuló üzenetekhez.
Azure Operator Call Protection – előzetes verzió Támogatott (a Számkezelési portál alternatívaként) - Azt jelzi, hogy a számok engedélyezve vannak az Azure Operator Call Protection esetében.
- Az Azure Operator Call Protection automatikus kiépítése.

Tipp.

Az Azure Communications Gateway számkezelési portálja egyenértékű funkciót biztosít a manuális kiépítéshez. A szolgáltatás elindítása után azonban nem használhatja a Számkezelési portált a Szolgáltatói kapcsolat és a Teams Telefon Mobile folyamatszintű kiépítéséhez.

Előfeltételek

Be kell fejeznie az Azure Communications Gateway üzembe helyezését.

Hozzáféréssel kell rendelkeznie egy olyan IP-címmel rendelkező géphez, amely jogosult a Provisioning API (előzetes verzió) elérésére. Az IP-címek (vagy tartományok) engedélyezési listája az Azure Communications Gateway üzembe helyezésének részeként lett konfigurálva.

Ismerje meg a Provisioning API-t (előzetes verzió), és tervezze meg a BSS-ügyfél módosításait

Az API-val való integrációhoz létre kell hoznia (vagy frissítenie kell) egy BSS-ügyfelet, amely kapcsolatba léphet a Kiépítési API-val. A Kiépítési API támogatja a gépről gépre irányuló OAuth 2.0 ügyfél hitelesítő adatok hitelesítési folyamatát. Az ügyfél a felhasználók beavatkozása nélkül hitelesíti és kezdeményezi az engedélyezett API-hívásokat.

Az API-referencia kulcsfogalmaival és példákat tartalmazó információival megismerheti az API-ban elérhető erőforrásokat és a szervezet által igényelt kéréseket.

  • A fiókerőforrások az operátori ügyfelek (általában egy vállalat) leírásai és a szolgáltatáskiépítés ügyfélenkénti beállításai.
  • A szám típusú erőforrások egy fiókhoz tartoznak. Ismertetik a számokat, a számokat használó szolgáltatásokat (például a Microsoft Teams közvetlen útválasztását), valamint a számonkénti extra konfigurációt.
  • Az információkérési (RFI-) erőforrások az operátori ügyfelek (jellemzően egy vállalat) leírásai, akik érdeklődésüket fejezték ki az operátortól a Szolgáltatói kapcsolat és a Teams Telefon Mobile szolgáltatásának fogadása iránt.

A Kiépítési API sebességkorlátja percenként 100 kérés, amely az összes erőforrásra vonatkozik. Egy kötegelt kérelem, amely több erőforrás frissítésére szolgál, egyetlen kérelemnek számít.

A BSS-ügyfél konfigurálása az Azure Communications Gatewayhez való csatlakozáshoz

A Provisioning API (előzetes verzió) az Azure Communications Gateway-erőforrás 443-es provapi.<base-domain>portján érhető el, ahol <base-domain> az Azure Communications Gateway-erőforrás alaptartománya.

Tipp.

Az alaptartomány megkeresése:

  1. Jelentkezzen be az Azure Portalra.
  2. Nyissa meg az Azure Communications Gateway-erőforrás áttekintését , és válassza a Tulajdonságok lehetőséget.
  3. Keresse meg a Tartomány nevű mezőt.

A DNS-rekord élettartama (TTL) 60 másodperc. Ha egy régió meghibásodik, az Azure frissíti a DNS-rekordot, hogy egy másik régióra hivatkozzon, így az új DNS-keresést készítő ügyfelek megkapják az új régió adatait. Javasoljuk, hogy az ügyfelek egy időtúllépés vagy 5xx válasz után 60 másodperccel végezzenek új DNS-kereséseket, és próbálkozzon újra egy kéréssel.

Az API-referencia Első lépések szakaszában konfigurálhatja az Azure-t és a BSS-ügyfelet, hogy a BSS-ügyfél hozzáférhessen a Kiépítési API-hoz.

Az alábbi lépések összefoglalják a szükséges Azure-konfigurációt. Az API-referencia Első lépések szakaszában részletes információkat talál, beleértve a szükséges konfigurációs értékeket is.

  1. Regisztrálja A BSS-ügyfelet ugyanabban az Azure-bérlőben, mint az Azure Communications Gateway üzembe helyezése. Ez a folyamat létrehoz egy alkalmazásregisztrációt.
  2. Rendelje hozzá magát tulajdonosként az alkalmazásregisztrációhoz.
  3. Konfigurálja az alkalmazásregisztrációt az API-referenciaban meghatározott hatókörökkel. Ez a konfiguráció azt jelzi az Azure-nak, hogy az alkalmazás számára engedélyezett a Kiépítési API elérése.
  4. A bérlő rendszergazdájaként engedélyezze az alkalmazás számára a hozzárendelt alkalmazásszerepkörök használatát.

Következő lépések