Skip Navigation LinksALVAO 11.2Rozšiřující modulyALVAO Asset Management Enterprise APIAutentikace Skip Navigation Links.


Skip Navigation LinksALVAO 11.2 / Rozšiřující moduly / ALVAO Asset Management Enterprise API / Autentikace

Autentikace

Pro přístup k rozhraní REST API můžete použít ověření Microsoft Entra ID (ME-ID) nebo základní ověření.

Oprávnění pro operace rozhraní REST API se řídí oprávněními přistupujícího uživatele v systému Alvao.

Microsoft Entra ID

Nejprve v systému Alvao nastavte ověřování uživatele Microsoft Entra ID.

Aplikace s přihlášeným uživatelem (jménem)

Aby bylo možné přistupovat k rozhraní REST API z interaktivní aplikace, do které jsou přihlášeni uživatelé (např. webová nebo mobilní aplikace), je třeba do systému Alvao importovat účty těchto uživatelů. Pro ověření přístupu proveďte následující kroky:

  1. Ověřte uživatele pomocí příslušného tokenu v aplikaci Microsoft Entra ID, kterou jste přiřadili k aplikaci Alvao.
  2. Získaný token předejte rozhraní REST API v hlavičce HTTP Authorization: bearer <token>.

Neinteraktivní aplikace

Pro přístup z aplikací nebo skriptů, které nepracují s přihlášeným uživatelem (např. integrační skript), postupujte následovně:

  1. V aplikaci Microsoft Entra ID spojené s Alvao v sekci Registrace aplikace přidejte volitelný token(viz více)
    1. V aplikaci přejděte do části Konfigurace tokenu.
    2. Klikněte na možnost Přidat volitelný nárok.
    3. V položce Typ tokenu vyberte možnost Přístup a deklarace idtyp a potvrďte tlačítkem Přidat
  2. V aplikaci Microsoft Entra ID zaregistrujte novou aplikaci, která bude komunikovat s rozSprávaAPI.
  3. Vytvořte nového uživatele v nabídce Administrace - Uživatelé. Zapněte možnost Účet aplikace, vyberte typ aplikace Microsoft Entra ID a přidejte údaje o aplikaci zaregistrované v předchozím kroku. Poté přiřaďte účtu potřebná oprávnění v aplikaci Alvao.
  4. Získejte token pro aplikaci z kroku 2 pomocí toku Client credentials (nastavte jako scope: <Client ID ALVAO application>/.default) a předejte jej rozhraní REST API v hlavičce HTTP Authorization: bearer <token>.

Základní ověření

Základní ověření je určeno pouze pro přístup z neinteraktivních aplikací.

    Správa
  1. Vytvořte nového uživatele v nabídce Administrace - Uživatelé. Zapněte možnost Účet aplikace a vyberte typ Ostatní aplikace. Poté nastavte heslo účtu a přiřaďte požadovaná oprávnění v aplikaci Alvao.
  2. Předejte uživatelské jméno a heslo rozhraní REST API prostřednictvím standardní hlavičky základního ověření.
Tip: V případě, že se vám podařilo získat přístup k systému Ravenva, použijte funkci Ravenva:
Doporučujeme používat bezpečnější způsob ověřování prostřednictvím Microsoft Entra ID

 

Nenašli jste co jste hledali? Zeptejte se našeho týmu technické podpory.