Självstudie: Konfigurera XM Fax och XM SendSecure för automatisk användaretablering

I den här självstudien beskrivs de steg du behöver utföra i både XM Fax och XM SendSecure och Microsoft Entra ID för att konfigurera automatisk användaretablering. När det konfigureras etablerar och avetablerar Microsoft Entra-ID automatiskt användare till XM Fax och XM SendSecure med hjälp av Microsoft Entra-etableringstjänsten. Viktig information om vad den här tjänsten gör, hur den fungerar och vanliga frågor finns i Automatisera användaretablering och avetablering till SaaS-program med Microsoft Entra-ID.

Funktioner som stöds

• Skapa användare i XM Fax och XM SendSecure.
• Ta bort användare i XM Fax och XM SendSecure när de inte längre behöver åtkomst.
• Behåll användarattribut synkroniserade mellan Microsoft Entra ID och XM Fax och XM SendSecure.
• Enkel inloggning till XM Fax och XM SendSecure (rekommenderas).

Förutsättningar

Scenariot som beskrivs i den här självstudien förutsätter att du redan har följande förutsättningar:

• En Microsoft Entra-klientorganisation
• En av följande roller: Programadministratör, Molnprogramadministratör eller Programägare.
• Ett användarkonto i XM Fax och XM SendSecure med administratörsbehörighet.

Steg 1: Planera etableringsdistributionen

• Lär dig mer om hur etableringstjänsten fungerar.
• Ta reda på vem som finns i etableringsomfånget.
• Ta reda på vilka data som ska mappas mellan Microsoft Entra ID och XM Fax och XM SendSecure.

Steg 2: Konfigurera XM Fax och XM SendSecure för att stödja etablering med Microsoft Entra-ID

Skapa en åtkomsttoken

1. I ditt XM Cloud Enterprise-konto klickar du på Åtkomsttoken för företagsnamn>.
2. Skapa en ny åtkomsttoken med behörigheten Användaretablering (med SCIM).
3. Kopiera åtkomsttoken. Du behöver den som hemlig token i Microsoft Entra-ID.

Klientorganisations-URL

• För att konfigurera Microsoft Entra-etableringstjänsten behöver du din klient-URL.

• Klient-URL:en beror på regionen, namnet på ditt företagskonto och har följande schema: https://<domain>/api/scim/v2/enterprises/<enterprise_name>/

Exempel:

• https://portal.xmedius.com/api/scim/v2/enterprises/acme/
• https://portal.xmedius.eu/api/scim/v2/enterprises/my_corporation/
• https://portal.xmedius.ca/api/scim/v2/enterprises/another_company/

Steg 3: Lägg till XM Fax och XM SendSecure från Microsoft Entra-programgalleriet

Lägg till XM Fax och XM SendSecure från Microsoft Entra-programgalleriet för att börja hantera etablering till XM Fax och XM SendSecure. Om du tidigare har konfigurerat XM Fax och XM SendSecure för enkel inloggning kan du använda samma program. Vi rekommenderar dock att du skapar en separat app när du testar integreringen från början. Lär dig mer om att lägga till ett program från galleriet här.

Steg 4: Definiera vem som ska finnas i omfånget för etablering

Med Microsoft Entra-etableringstjänsten kan du omfångsbegränsa vem som ska etableras baserat på tilldelning till programmet och eller baserat på användarens attribut. Om du väljer att omfånget vem som ska etableras i din app baserat på tilldelning kan du använda följande steg för att tilldela användare till programmet. Om du väljer att omfånget vem som ska etableras enbart baserat på användarens attribut kan du använda ett omfångsfilter enligt beskrivningen här.

• Starta i liten skala. Testa med en liten uppsättning användare innan du distribuerar till alla. När omfånget för etablering är inställt på tilldelade användare kan du styra detta genom att tilldela en eller två användare till appen. När omfånget är inställt på alla användare kan du ange ett attributbaserat omfångsfilter.

• Om du behöver fler roller kan du uppdatera programmanifestet för att lägga till nya roller.

Steg 5: Konfigurera automatisk användaretablering till XM Fax och XM SendSecure

Det här avsnittet vägleder dig genom stegen för att konfigurera Microsoft Entra-etableringstjänsten för att skapa, uppdatera och inaktivera användare i TestApp baserat på användartilldelningar i Microsoft Entra-ID.

Så här konfigurerar du automatisk användaretablering för XM Fax och XM SendSecure i Microsoft Entra-ID:

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

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

   

3. I programlistan väljer du XM Fax och XM SendSecure.

   

4. Välj fliken Etablering.

   

5. Ange Etableringsläge som Automatiskt.

   

6. Under avsnittet Autentiseringsuppgifter för administratör anger du din URL för XM-fax och XM SendSecure-klientorganisation och hemlig token från steg 2. Klicka på Test Anslut ion för att se till att Microsoft Entra ID kan ansluta till XM Fax och XM SendSecure. Om anslutningen misslyckas kontrollerar du att URL:en och åtkomsttoken är korrekta.

   

7. I fältet E-postavisering anger du e-postadressen till en person som ska få meddelanden om etableringsfel och markerar kryssrutan Skicka ett e-postmeddelande när ett fel inträffar .

   

8. Välj Spara.

9. Under avsnittet Mappningar väljer du Synkronisera Microsoft Entra-användare till XM Fax och XM SendSecure.

10. Granska de användarattribut som synkroniseras från Microsoft Entra-ID till XM Fax och XM SendSecure i avsnittet Attributmappning . Attributen som valts som Matchande egenskaper används för att matcha användarkontona i XM Fax och XM SendSecure för uppdateringsåtgärder. Om du väljer att ändra det matchande målattributet måste du se till att XM Fax- och XM SendSecure-API:et stöder filtrering av användare baserat på det attributet. Välj knappen Spara för att checka in eventuella ändringar.

    Attribut	Typ	Stöds för filtrering	Krävs av XM Fax och XM SendSecure
    userName	String	✓	✓
    emails[type eq "work"].value	String		✓
    aktiv	Booleskt
    rubrik	String
    name.givenName	String
    name.familyName	String
    addresses[type eq "work"].streetAddress	String
    addresses[type eq "work"].locality	String
    addresses[type eq "work"].region	String
    addresses[type eq "work"].postalCode	String
    addresses[type eq "work"].country	String
    phoneNumbers[type eq "work"].value	String
    phoneNumbers[type eq "mobile"].value	String
    phoneNumbers[type eq "fax"].value	String
    externalId	String		✓
    roles[primary eq "True"].value	String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization	String

11. Information om hur du konfigurerar omfångsfilter finns i följande instruktioner i självstudien för omfångsfilter.

12. Om du vill aktivera Microsoft Entra-etableringstjänsten för XM Fax och XM SendSecure ändrar du Etableringsstatus till På i avsnittet Inställningar.

    

13. Definiera de användare som du vill etablera till XM Fax och XM SendSecure genom att välja önskade värden i Omfång i avsnittet Inställningar.

    

14. När du är redo att etablera klickar du på Spara.

    

Den här åtgärden startar den inledande synkroniseringscykeln för alla användare som definierats i Omfång i avsnittet Inställningar. Den inledande cykeln tar längre tid att utföra än efterföljande cykler, som inträffar ungefär var 40:e minut så länge Microsoft Entra-etableringstjänsten körs.

Steg 6: Övervaka distributionen

När du har konfigurerat etableringen använder du följande resurser till att övervaka distributionen:

• Använd etableringsloggarna för att se vilka användare som har etablerats och vilka som har misslyckats
• Kontrollera förloppsindikatorn för att se status för etableringscykeln och hur nära etableringscykeln är klar
• Om etableringskonfigurationen verkar vara i ett feltillstånd hamnar programmet i karantän. Läs mer om karantänstatus här.

Fler resurser

• Hantera användarkontoetablering för Enterprise-appar
• Vad är programåtkomst och enkel inloggning med Microsoft Entra-ID?

Nästa steg

• Lär dig att granska loggar och hämta rapporter om etableringsaktivitet