Integrieren Sie Lucid SAML SSO mit Active Directory Federation Services (ADFS)

Geschrieben von:  Shanna S
Letzte Aktualisierung:  

Durch die Integration von Lucid mit ADFS können sich Ihre Benutzer mit SAML-Single-Sign-On über ADFS authentifizieren. Das folgende Tutorial führt durch den Prozess der Integration von ADFS mit Lucid.

Verfügbarkeit des Tarifs: Nur Enterprise .

Laden Sie die Föderationsmetadaten herunter und importieren Sie sie in Lucid

  1. Laden Sie die Metadaten der Föderation herunter. 
    • Die Föderationsmetadaten können auf dem ADFS-Server unter folgender URL abgerufen werden, wobei [myserver.domain] ersetzt wird, um Ihre ADFS-Server-URL wiederzugeben:
      https://[myserver.domain].com/FederationMetadata/2007-06/FederationMetadata.xml
  2. Navigieren Sie zum Admin-Panel von Lucid.
  3. Wählen Sie die Registerkarte App-Integration .
  4. Wählen Sie im Dropdown-Menü „App-Integration“ die Option „Allgemein“aus.
  5. Klicken Sie in der Integrationskachel „SAML“ auf Einstellungen .
  6. Laden Sie die XML-Metadaten mithilfe der Dateiauswahl in Lucid hoch.
    • Hinweis: Wenn Sie dies im Textformat haben, speichern Sie es bitte als XML-Datei und laden Sie es dann auf Lucid hoch.

Konfigurieren Sie den Lucid Relying Party Trust in ADFS

Erstellen und konfigurieren Sie als Nächstes einen Relying Party Trust mithilfe der Lucid-Metadaten. 

Hinweis: Befolgen Sie diese genauen Anweisungen, unabhängig davon, ob Sie Lucidchart, Lucidspark oder beide verwenden.

  1. Wählen Sie auf der Lucid-SAML-Seite Metadaten herunterladen aus , um die Lucid-Metadaten herunterzuladen.
  2. Speichern Sie die Metadaten an einem Ort, an dem der ADFS-Server zugänglich ist.
    section-of-the-admin-panel-app-integration-tab-to-save-metadata.png
  3. Öffnen Sie ADFS und klicken Sie mit der rechten Maustaste auf Relying Party Trust.
  4. Wähle im Menü "Vertrauensperson der Partei hinzufügen ", um den Wizard "Vertrauenspartei hinzufügen" zu öffnen.
    add-relying-party-selection-in-adfs.png
  5. Klicken Sie sich durch die Eingabeaufforderungen auf dem Willkommensbildschirm.
  6. Wählen Sie im Bildschirm „Datenquelle auswählen“ die Option „Daten über die vertrauende Seite aus einer Datei importieren“aus.
  7. Wählen Sie „Durchsuchen“ und suchen Sie die Lucid-Metadatendatei.
  8. Füllen Sie die verbleibenden Einstellungen basierend auf den Vorlieben Ihrer Organisation aus.
    add-relying-party-trust-wizard-in-adfs.png
  9. Öffnen Sie die Endpunktkonfiguration für Ihre Lucid-Vertrauensstellung. 
    • Sie müssen einen weiteren Endpunkt hinzufügen, um die Speicherung der eingehenden Anmelde-URL durch ADFS anhand der bereitgestellten ACS-/Antwort-URL zu ermöglichen. Die Einstellungen sollten sein:
      • Typ = SAML-Konsumentenbehauptung
      • Bindung = POST
      • Index = 1
      • Vertrauenswürdige URL = https://www.lucidchart.com/saml/sso/IDP-Entitäts-ID

      • Sobald Sie fertig sind, sieht die Konfiguration folgendermaßen aus:
        example-of-an-adfs-endpoint.png
  10. Klicken Sie mit der rechten Maustaste auf den Lucid Relying Party Trust und wählen Sie Anspruchsregeln bearbeitenaus.
  11. Fügen Sie eine Claim-Regel mit LDAP hinzu und konfigurieren Sie die Claim-Regel so, dass sie den unten gezeigten Attributen und Claim-Typen entspricht.
    example-of-how-to-add-a-claim-rule-in-adfs.png
  12. Klicken Sie auf Fertigstellen.

Jetzt haben Sie die ADFS-SAML-Integration in Lucid abgeschlossen und Ihr Lucid-Konto unterstützt die SAML-Single-Sign-On-Authentifizierung über ADFS.

Sie haben die Möglichkeit, verschlüsselte Assertions für die Identitätsanbieter zu verwenden, die Sie Ihrem Lucid-Konto für SAML hinzufügen. Weitere Informationen finden Sie in unserem SAML-Übersichtsartikel.

Ich brauche immer noch Hilfe

Fehlerbehebung

Ungültige SAML-Antwort

Dieser Fehler korrespondiert mit einer falschen SAML-Antwort des IDP. Er bedeutet normalerweise, dass der Hash-Algorithmus im ADFS von "SHA-1" auf "SHA-256" umgestellt werden muss. Navigieren Sie zum Lucid Relying Party Trust, klicken Sie mit der rechten Maustaste, und wählen Sie "Eigenschaften". Klicken Sie auf die Registerkarte "Erweitert" und schalten Sie den Hash-Algorithmus von "SHA-1" auf "SHA-256" um.

SAML wurde für Ihr Team nicht konfiguriert. Fordern Sie eine Einladung von einem für SAML aktivierten Team an.

Dieser Fehler erscheint, wenn ein Benutzer, der versucht, sich über SAML anzumelden, nicht mit dem SAML-aktivierten Team verbunden ist. Der Admin muss eine Einladung an den Benutzer senden, um in das Team aufgenommen zu werden. Wählen Sie im Lucid Admin Panel "Benutzer". Klicken Sie auf "+Benutzer" in der oberen rechten Ecke und geben Sie die E-Mail des Benutzers ein.

Ungültiges Identitätsattribut

Dieser Fehler zeigt an, dass in der SAML-Antwort ein ungültiges Identitätsattribut empfangen wurde. Konfigurieren Sie ein Claim-Attribut für den Lucid Relying Party Trust, wobei "E-Mail-Adressen" mit "Namens-ID" in ADFS übereinstimmt.

XML konnte nicht geparst werden

Diese Fehlermeldung zeigt eine fehlerhafte Syntax in den XML-Metdaten des Identity Providers an. Dies kann passieren, wenn Metadaten über ein Internet-Explorer-Fenster heruntergeladen werden. Internet Explorer fügt Gedankenstriche in die XML-Tags zum Auf- und Zuklappen ein. Sie können dieses Problem beheben, indem Sie entweder die XML-Daten in einem Texteditor öffnen oder alle Gedankenstriche im kopierten XML-Text löschen.

Erstellung von Nutzern benutzername_12345@beispiel.com

Die Lucid SAML-Integration akzeptiert 3 Attribute: Vorname, Nachname und E-Mail-Adresse. Wenn eine ungültige E-Mail-Adresse vom SAML-Identitätsprovider übergeben wird, wird eine gültige E-Mail generiert, um den Benutzer anzulegen: "Übergebener Wert" + "SAML-ID" + "@beispiel.com". Dies tritt häufig auf, wenn ein Benutzername oder Vorname anstelle der gültigen E-Mail-Adresse an das E-Mail-Adressen-Attribut übergeben wird. Sie können dieses Problem lösen, indem Sie Ihre Anspruchsregel so konfigurieren, dass eine gültige E-Mail-Adresse im Attribut E-Mail-Adresse gesendet wird.

ADFS schickt keine Antwort an Lucid

Überprüfen Sie die Endpunkte, um sicherzustellen, dass Sie die in den ADFS-Einrichtungsschritten aufgeführten Schritte befolgt haben. Wenn Sie nur einen einzigen Endpunkt haben oder Ihren www.-Endpunkt vor Ihrem app. Endpunkt indiziert haben, wird die Antwort nicht zu Lucid zurückkehren.

Geben Sie Feedback zu diesem Artikel

Haben Sie Feedback zu diesem Artikel? Berichten Sie uns hier von Ihren Erfahrungen. 

Haben Sie gefunden wonach Sie gesucht haben?

Haben Sie noch eine Frage oder möchten Sie Ihre Erfahrungen mit anderen teilen? Besuchen Sie unsere Community, um Hilfe zu bekommen und mit anderen zusammenzuarbeiten.