Robot regisztrálása az Azure-ban
A KÖVETKEZŐKRE VONATKOZIK: SDK v4
Ha jelenleg nem üzemelteti a robotot az Azure-ban, akkor is elérhetővé teheti az Azure-ban, és az Azure használatával csatlakoztathatja a robotot a csatornákhoz. Ehhez adja meg az Azure-ban azt a webcímet, ahol a robot üzemel.
Ez a cikk bemutatja, hogyan regisztrálhat egy ilyen robotot az Azure Bot Service.
Fontos
Csak akkor kell regisztrálnia egy robotot, ha az nem az Azure-ban van üzemeltetve. Az Azure CLI használatával létrehozott robotok már regisztrálva vannak az Azure Bot Service.
A robot identitása többféleképpen kezelhető az Azure-ban.
- Felhasználó által hozzárendelt felügyelt identitásként, hogy ne kelljen saját maga felügyelnie a robot hitelesítő adatait.
- Egybérlős alkalmazásként.
- Több-bérlős alkalmazásként.
A 4.15.0-s verzióban a C# és a JavaScript esetében a felhasználó által hozzárendelt felügyelt identitás és egybérlős alkalmazástípusok támogatása lett hozzáadva a Bot Framework SDK-hoz. Ezek az alkalmazástípusok más nyelveken, Bot Framework Composer, Bot Framework Emulator vagy ngrok nyelven nem támogatottak.
| Alkalmazástípus | Támogatás |
|---|---|
| Felhasználó által hozzárendelt felügyelt identitás | Az Azure Bot Service, valamint a C# és JavaScript SDK-k |
| Egybérlős | Az Azure Bot Service, valamint a C# és JavaScript SDK-k |
| Több-bérlős | Azure Bot Service, a Bot Framework SDK összes nyelve, Composer, a Emulator és az ngrok |
Ez a cikk nem ismerteti, hogyan hozhatja létre vagy helyezheti üzembe a robotot a regisztrációhoz. További információkért lásd:
- Robot létrehozása – rövid útmutató
- Alapszintű robot üzembe helyezése oktatóanyag
Az erőforrás létrehozása
Hozza létre az Azure Bot-erőforrást, amellyel regisztrálhatja a robotot az Azure Bot Service.
Tipp
Az Azure-webalkalmazás-robotok és robotcsatornák regisztrációs erőforrástípusai elavultak. Az elavulás előtt konfigurált és üzembe helyezett erőforrások továbbra is működni fognak. A VSIX- vagy Yeoman-sablonból az SDK 4.14.1.2-es vagy újabb verziójából létrehozott robotok OLYAN ARM-sablonokat tartalmaznak, amelyek létrehoznak egy Azure Bot-erőforrást.
Nyissa meg az Azure Portal.
A jobb oldali panelen válassza az Erőforrás létrehozása lehetőséget.
A keresőmezőbe írja be az Enter billentyűt
bot, majd nyomja le az Enter billentyűt.Válassza ki az Azure Bot-kártyát .
Válassza a Létrehozás lehetőséget.
Adja meg az értékeket a kötelező mezőkben. Válassza ki, hogy milyen típusú alkalmazást szeretne létrehozni, és hogy meglévő vagy új identitásadatokat szeretne-e használni.
Válassza az Áttekintés + létrehozás lehetőséget.
Ha az ellenőrzés sikeres, válassza a Létrehozás lehetőséget.
Az üzembe helyezés befejezése után válassza az Erőforrás megnyitása lehetőséget. A robotnak és a kapcsolódó erőforrásoknak meg kell jelennie a kiválasztott erőforráscsoportban.
Ha még nem rendelkezik a Bot Framework SDK-val, válassza a Letöltés GitHub lehetőséget, hogy megtudja, hogyan használhatja fel a csomagokat az előnyben részesített nyelvhez.
Most már készen áll a robot összeállítására a Bot Framework SDK-val.
Tipp
Amikor az Azure létrehoz egy új egybérlős vagy több-bérlős Azure Bot-erőforrást egy új alkalmazásazonosítóval, egy jelszót is létrehoz.
Robot identitásadatai
Az alábbi lépéseket követve adja hozzá az identitásadatokat a robot konfigurációs fájljához. A fájl a robot létrehozásához használt programozási nyelvtől függően eltérő.
Fontos
A Bot Framework SDK Java és Python verziói csak a több-bérlős robotokat támogatják. A C# és a JavaScript verziók mind a három alkalmazástípust támogatják a robot identitásának kezeléséhez.
| Nyelv | Fájlnév | Jegyzetek |
|---|---|---|
| C# | appsettings.json | Mind a három alkalmazástípust támogatja a robot identitásának kezeléséhez. |
| JavaScript | .env | Mind a három alkalmazástípust támogatja a robot identitásának kezeléséhez. |
| Java | application.properties | Csak a több-bérlős robotokat támogatja. |
| Python | config.py | Csak a több-bérlős robotokat támogatja. Adja meg az identitástulajdonságokat argumentumként a os.environ.get metódushívásokhoz. |
A hozzáadni kívánt identitásadatok a robot alkalmazástípusától függenek. Adja meg a következő értékeket a konfigurációs fájlban.
Csak C# és JavaScript robotokhoz érhető el.
| Tulajdonság | Érték |
|---|---|
MicrosoftAppType |
UserAssignedMSI |
MicrosoftAppId |
A felhasználó által hozzárendelt felügyelt identitás ügyfél-azonosítója. |
MicrosoftAppPassword |
Nem alkalmazható. Ezt hagyja üresen egy felhasználó által hozzárendelt felügyelt identitást használó robot esetében. |
MicrosoftAppTenantId |
A felhasználó által hozzárendelt felügyelt identitás bérlőazonosítója. |
Ha már rendelkezik webalkalmazás-erőforrással a robothoz, és a robot egy felhasználó által hozzárendelt felügyelt identitásalkalmazás , előfordulhat, hogy frissítenie kell a robot webalkalmazását:
- Nyissa meg a robot webalkalmazásának App Service paneljét.
- A Gépház területen válassza az Identitás lehetőséget.
- Az Identitás panelen válassza a Felhasználóhoz rendelt lapot, majd a Hozzáadás (+) lehetőséget.
- A Felhasználó által hozzárendelt felügyelt identitás hozzáadása panelen:
Válassza ki előfizetését.
Felhasználó által hozzárendelt felügyelt identitások esetében válassza ki a robot felügyelt identitását. Ha a felügyelt identitás automatikusan létre lett hozva Önnek, ugyanaz lesz a neve, mint a robotnak.
Válassza a Hozzáadás lehetőséget, ha ezt az identitást szeretné használni a robothoz.
A robot alkalmazás- vagy bérlőazonosítójának lekérése:
- Nyissa meg a robot Azure Bot-erőforrás paneljét.
- Lépjen a robot Konfiguráció paneljére. Ezen a panelen átmásolhatja a robot Microsoft-alkalmazásazonosítóját vagy alkalmazás-bérlőazonosítóját.
Az egybérlős és a több-bérlős robotok rendelkeznek egy alkalmazáskulcstal vagy jelszóval, amely bizonyos műveletekhez szükséges. Az Azure Bot Service elrejti a robot titkos kódját. A robot webalkalmazás-erőforrásának tulajdonosa azonban létrehozhat egy új jelszót:
- Nyissa meg a robot Azure Bot-erőforrás paneljét.
- Lépjen a robot Konfiguráció paneljére.
- A Microsoft-alkalmazásazonosító melletti Kezelés elemet választva lépjen a webalkalmazás Tanúsítványok + titkos kódok paneljére.
- A panelen található utasításokat követve hozzon létre egy új titkos ügyfélkulcsot, és rögzítse az értéket egy biztonságos helyen.
Manuális alkalmazásregisztráció
Manuális regisztrációra van szükség, ha:
- Nem tudja elvégezni a regisztrációkat a szervezetében, és egy másik félnek kell létrehoznia az alkalmazásazonosítót az ön által létrehozott robothoz.
- Manuálisan kell létrehoznia saját alkalmazásazonosítóját és jelszavát.
A robot frissítése
Ha frissíteni szeretné a robot konfigurációs fájlját, hogy tartalmazza az alkalmazásazonosítóját és jelszavát, tekintse meg az alkalmazásazonosítót és a jelszót a robotregisztrációs beállítások konfigurálásához.
További információ
Az Azure-alkalmazásokkal kapcsolatos általános információkért tekintse meg ezeket a cikkeket.
| Tárgy | Cikk |
|---|---|
| Alkalmazásregisztráció | Gyorsútmutató: Alkalmazás regisztrálása a Microsoft Identitásplatformon |
| Felügyelt identitások | Mik az Azure-erőforrások felügyelt identitásai? |
| Egybérlős és több-bérlős alkalmazások | Bérlői viszony az Azure Active Directoryban |