Självstudie: Microsoft Entra-integrering med enkel inloggning (SSO) med Documo

  • Artikel

I den här självstudien får du lära dig hur du integrerar Documo med Microsoft Entra-ID. När du integrerar Documo med Microsoft Entra-ID kan du:

  • Kontroll i Microsoft Entra-ID som har åtkomst till Documo.
  • Gör så att dina användare automatiskt loggas in på Documo med sina Microsoft Entra-konton.
  • Hantera dina konton på en central plats.

Förutsättningar

För att komma igång behöver du följande:

  • En Microsoft Entra-prenumeration. Om du inte har en prenumeration kan du få ett kostnadsfritt konto.
  • Documo-prenumeration med enkel inloggning (SSO) aktiverat.

Beskrivning av scenario

I den här självstudien konfigurerar och testar du Microsoft Entra SSO i en testmiljö.

Kommentar

Identifieraren för det här programmet är ett fast strängvärde så att endast en instans kan konfigureras i en klientorganisation.

För att konfigurera integreringen av Documo i Microsoft Entra-ID måste du lägga till Documo från galleriet i din lista över hanterade SaaS-appar.

  1. Logga in på administrationscentret för Microsoft Entra som minst molnprogramadministratör.
  2. Bläddra till Identity>Applications Enterprise-program>>Nytt program.
  3. I avsnittet Lägg till från galleriet skriver du Documo i sökrutan.
  4. Välj Documo i resultatpanelen och lägg sedan till appen. Vänta några sekunder medan appen läggs till i din klientorganisation.

Du kan också använda guiden Konfiguration av företagsappar. I den här guiden kan du lägga till ett program i din klientorganisation, lägga till användare/grupper i appen, tilldela roller samt gå igenom SSO-konfigurationen. Läs mer om Microsoft 365-guider.

Konfigurera och testa Microsoft Entra SSO for Documo

Konfigurera och testa Microsoft Entra SSO med Documo med hjälp av en testanvändare med namnet B.Simon. För att enkel inloggning ska fungera måste du upprätta en länkrelation mellan en Microsoft Entra-användare och den relaterade användaren i Documo.

Utför följande steg för att konfigurera och testa Microsoft Entra SSO med Documo:

  1. Konfigurera Microsoft Entra SSO – så att användarna kan använda den här funktionen.
    1. Skapa en Microsoft Entra-testanvändare – för att testa enkel inloggning med Microsoft Entra med B.Simon.
    2. Tilldela Microsoft Entra-testanvändaren – för att göra det möjligt för B.Simon att använda enkel inloggning med Microsoft Entra.
  2. Konfigurera Documo SSO – för att konfigurera inställningarna för enkel inloggning på programsidan.
    1. Skapa Documo-testanvändare – för att ha en motsvarighet till B.Simon i Documo som är länkad till Microsoft Entra-representationen av användaren.
  3. Testa enkel inloggning – för att kontrollera om konfigurationen fungerar.

Konfigurera enkel inloggning med Microsoft Entra

Följ de här stegen för att aktivera Enkel inloggning i Microsoft Entra.

  1. Logga in på administrationscentret för Microsoft Entra som minst molnprogramadministratör.

  2. Bläddra till Identity>Applications Enterprise-program>> Documo>Enkel inloggning.

  3. På sidan Välj en enkel inloggningsmetod väljer du SAML.

  4. På sidan Konfigurera enkel inloggning med SAML klickar du på pennikonen för Grundläggande SAML-konfiguration för att redigera inställningarna.

    Edit Basic SAML Configuration

  5. I avsnittet Grundläggande SAML-konfiguration behöver användaren inte utföra några steg eftersom appen redan är förintegrerad med Azure. Om ditt Documo-konto har en anpassad domän måste du också ha en anpassad API-domän för att enkel inloggning ska fungera. Ersätt standardvärdena med din anpassade API-domän, till exempel https://mycustomapidomain.com och https://mycustomapidomain.com/assert.

  6. Klicka på Ange ytterligare URL:er och gör följande om du vill konfigurera appen i SP-initierat läge:

    I textrutan Inloggnings-URL skriver du URL:en:
    https://app.documo.com/sso

  7. Klicka på Spara.

  8. På sidan Konfigurera enkel inloggning med SAML går du till avsnittet SAML-signeringscertifikat och letar upp XML för federationsmetadata och väljer Ladda ned för att ladda ned certifikatet och spara det på datorn.

    The Certificate download link

  9. I avsnittet Konfigurera Documo kopierar du lämpliga URL:er baserat på dina behov.

    Copy configuration URLs

Skapa en Microsoft Entra-testanvändare

I det här avsnittet skapar du en testanvändare med namnet B.Simon.

  1. Logga in på administrationscentret för Microsoft Entra som minst användaradministratör.
  2. Bläddra till Identitetsanvändare>>Alla användare.
  3. Välj Ny användare>Skapa ny användare överst på skärmen.
  4. Följ dessa steg i användaregenskaperna :
    1. I fältet Visningsnamn anger du B.Simon.
    2. I fältet Användarens huvudnamn anger du username@companydomain.extension. Exempel: B.Simon@contoso.com
    3. Markera kryssrutan Visa lösenord och skriv sedan ned det värde som visas i rutan Lösenord.
    4. Välj Granska + skapa.
  5. Välj Skapa.

Tilldela Microsoft Entra-testanvändaren

I det här avsnittet gör du det möjligt för B.Simon att använda enkel inloggning genom att ge åtkomst till Documo.

  1. Logga in på administrationscentret för Microsoft Entra som minst molnprogramadministratör.
  2. Bläddra till Identity>Applications Enterprise-program>>Documo.
  3. På appens översiktssida väljer du Användare och grupper.
  4. Välj Lägg till användare/grupp och välj sedan Användare och grupper i dialogrutan Lägg till tilldelning .
    1. I dialogrutan Användare och grupper väljer du B.Simon i listan Användare och klickar sedan på knappen Välj längst ned på skärmen.
    2. Om du förväntar dig att en roll ska tilldelas till användarna kan du välja den i listrutan Välj en roll . Om ingen roll har konfigurerats för den här appen visas rollen "Standardåtkomst" markerad.
    3. I dialogrutan Lägg till tilldelning klickar du på knappen Tilldela.

Konfigurera enkel inloggning med Documo

  1. Logga in på din Documo-webbplats som administratör.

  2. Gå till kontot Inställningar ->Security.

    screenshot for security page.

  3. På fliken Säkerhet klickar du på knappen Konfigurera enkel inloggning längst ned på sidan.

    screenshot for configure button.

  4. Utför följande steg på sidan Konfigurera SAML .

    screenshot for configuration page.

    a. I textrutan Entitets-ID klistrar du in det Microsoft Entra-identifierarvärde som du kopierade tidigare.

    b. I textrutan URL för enkel inloggning (omdirigerings-URL) klistrar du in det inloggnings-URL-värde som du kopierade tidigare.

    c. Ange värdet e-postdomän i textrutan.

    d. Ange värdet i textrutan Fältnamn i SAML-token som innehåller e-post för identitet.

    e. Öppna den nedladdade XML:en för federationsmetadata i Anteckningar. Leta upp taggen <X509Certificate> och klistra in innehållet i textrutan Signer Certificate (Signer Certificate ).

    f. Klicka på Skicka.

Skapa Documo-testanvändare

I det här avsnittet skapas en användare med namnet B.Simon i Documo.

  1. Gå till sidan Användare i Documo-appen.
  2. Klicka på knappen Ny användare .
  3. Fyll i användarformuläret med namn, e-post, telefonnummer, användarroll och lösenordsinformation. Kontrollera att e-postfältet matchar e-postmeddelandet för B.Simon i Microsoft Entra-ID.
  4. Klicka på Skapa.

Testa enkel inloggning

I det här avsnittet testar du konfigurationen av enkel inloggning med Microsoft Entra med följande alternativ.

SP-initierad:

  • Klicka på Testa det här programmet. Detta omdirigeras till Documo Sign on URL där du kan initiera inloggningsflödet.

  • Gå till Documo-inloggnings-URL direkt och initiera inloggningsflödet därifrån.

IDP-initierad:

  • Klicka på Testa det här programmet så ska du automatiskt loggas in på Documo som du har konfigurerat enkel inloggning för

Du kan också använda Microsoft Mina appar för att testa programmet i valfritt läge. När du klickar på Documo-panelen i Mina appar omdirigeras du till inloggningssidan för att initiera inloggningsflödet om du har konfigurerat i IDP-läge. Om du har konfigurerats i SP-läge bör du automatiskt loggas in på Documo som du har konfigurerat enkel inloggning för. Mer information om Mina appar finns i Introduktion till Mina appar.

Nästa steg

När du har konfigurerat Documo kan du framtvinga sessionskontroll, vilket skyddar exfiltrering och infiltration av organisationens känsliga data i realtid. Sessionskontrollen utökas från villkorlig åtkomst. Lär dig hur du framtvingar sessionskontroll med Microsoft Defender för molnet Apps.