Tutorial: Integration des einmaligen Anmeldens (SSO) von Microsoft Entra in Coda

In diesem Tutorial erfahren Sie, wie Sie Coda mit Microsoft Entra ID integrieren. Die Integration von Coda in Microsoft Entra ID ermöglicht Folgendes:

• Steuern Sie in Microsoft Entra ID, wer Zugriff auf Coda hat.
• Sie können Ihren Benutzer*innen ermöglichen, sich mit ihren Microsoft Entra-Konten automatisch bei Coda anzumelden.
• Verwalten Sie Ihre Konten an einem zentralen Ort.

Voraussetzungen

Für die ersten Schritte benötigen Sie Folgendes:

• Ein Microsoft Entra-Abonnement. Falls Sie über kein Abonnement verfügen, können Sie ein kostenloses Azure-Konto verwenden.
• Coda-Abonnement (Enterprise), für das einmaliges Anmelden (Single Sign-On, SSO) aktiviert und die GDrive-Integration deaktiviert ist. Wenden Sie sich an das Coda-Supportteam, um die GDrive-Integration für Ihre Organisation zu deaktivieren, sollte sie derzeit aktiviert sein.

Beschreibung des Szenarios

In diesem Tutorial konfigurieren und testen Sie das einmalige Anmelden von Microsoft Entra in einer Testumgebung.

• Coda unterstützt IDP-initiiertes einmaliges Anmelden.

• Coda unterstützt die Just-In-Time-Benutzerbereitstellung.

• Coda unterstützt die automatisierte Benutzerbereitstellung.

Hinzufügen von Coda aus dem Katalog

Um die Integration von Coda in Microsoft Entra zu konfigurieren, müssen Sie Coda aus dem Katalog zu Ihrer Liste mit den verwalteten SaaS-Apps hinzufügen.

1. Melden Sie sich beim Microsoft Entra Admin Center mindestens als Cloudanwendungsadministrator an.
2. Navigieren Sie zu Identität>Anwendungen>Unternehmensanwendungen>Neue Anwendung.
3. Geben Sie im Abschnitt Aus Katalog hinzufügen den Suchbegriff Coda in das Suchfeld ein.
4. Wählen Sie im Ergebnisbereich Coda aus, und fügen Sie dann die App hinzu. Warten Sie einige Sekunden, während die App Ihrem Mandanten hinzugefügt wird.

Alternativ können Sie auch den Enterprise App Configuration Wizard verwenden. Mit diesem Assistenten können Sie Ihrem Mandanten eine Anwendung hinzufügen, der App Benutzer/Gruppen hinzufügen, Rollen zuweisen sowie die SSO-Konfiguration durchlaufen. Erfahren Sie mehr über Microsoft 365-Assistenten.

Konfigurieren und Testen des einmaligen Anmeldens (SSO) von Microsoft Entra für Coda

Konfigurieren und testen Sie das einmalige Anmelden von Microsoft Entra mit Coda mithilfe einer Testbenutzerin mit dem Namen B. Simon. Damit SSO funktioniert, muss eine Linkbeziehung zwischen einem Microsoft Entra-Benutzer und dem entsprechenden Benutzer in Coda eingerichtet werden.

Führen Sie zum Konfigurieren und Testen des einmaligen Anmeldens von Microsoft Entra mit Coda die folgenden Schritte aus:

1. Beginnen mit der Konfiguration des einmaligen Anmeldens für Coda , um einmaliges Anmelden in Coda zu konfigurieren
2. Konfigurieren des einmaligen Anmeldens von Microsoft Entra, um Ihren Benutzer*innen die Verwendung dieses Features zu ermöglichen.
   1. Erstellen Sie einen Microsoft Entra-Testbenutzer, um Microsoft Entra-SSO mit dem Testbenutzer B. Simon zu testen.
   2. Zuweisen der Microsoft Entra-Testbenutzerin, um B.Simon die Verwendung des einmaligen Anmeldens von Microsoft Entra zu ermöglichen.
3. Konfigurieren des einmaligen Anmeldens für Coda , um die Konfiguration der Einstellungen für einmaliges Anmelden in Coda abzuschließen
   1. Erstellen einer Coda-Testbenutzerin, um eine Entsprechung von B. Simon in Coda zu erhalten, die mit ihrer Darstellung in Microsoft Entra verknüpft ist.
4. Testen des einmaligen Anmeldens , um zu überprüfen, ob die Konfiguration funktioniert

Beginnen mit der Konfiguration des einmaligen Anmeldens für Coda

Führen Sie zunächst die folgenden Schritte in Coda aus:

1. Öffnen Sie in Coda das Panel Organization settings (Organisationseinstellungen).

   

2. Vergewissern Sie sich, dass die GDrive-Integration in Ihrer Organisation deaktiviert ist. Wenn sie derzeit aktiviert ist, wenden Sie sich an das Coda-Supportteam, um Unterstützung bei der Migration von GDrive zu einer anderen Lösung zu erhalten.

   

3. Aktivieren Sie unter Authenticate with SSO (SAML) (Authentifizieren mit SSO (SAML)) die Option Configure SAML (SAML konfigurieren).

   

4. Notieren Sie sich die Werte für Entity ID (Entitäts-ID) und SAML Response URL (SAML-Antwort-URL) zur späteren Verwendung.

   

Konfigurieren des einmaligen Anmeldens (SSO) von Microsoft Entra

Gehen Sie wie folgt vor, um das einmalige Anmelden von Microsoft Entra zu aktivieren.

1. Melden Sie sich beim Microsoft Entra Admin Center mindestens als Cloudanwendungsadministrator an.

2. Navigieren Sie zu Identität>Anwendungen>Unternehmensanwendungen>Coda>Einmaliges Anmelden.

3. Wählen Sie auf der Seite SSO-Methode auswählen die Methode SAML aus.

4. Klicken Sie auf der Seite Einmaliges Anmelden (SSO) mit SAML einrichten auf das Stiftsymbol für Grundlegende SAML-Konfiguration, um die Einstellungen zu bearbeiten.

   

5. Führen Sie auf der Seite Einmaliges Anmelden (SSO) mit SAML einrichten die folgenden Schritte aus:

   a. Geben Sie im Textfeld Bezeichner die Entitäts-ID ein, die Sie sich oben notiert haben. Sie muss folgendes Format haben: https://coda.io/samlId/<CUSTOMID>.

   b. Geben Sie im Textfeld Antwort-URL die SAML-Antwort-URL ein, die Sie sich oben notiert haben. Sie muss folgendes Format haben: https://coda.io/login/sso/saml/<CUSTOMID>/consume.

   Hinweis

   Ihre Werte unterscheiden sich von den obigen Werten. Sie finden Ihre Werte in der Coda-Konsole „Configure SAML“ (SAML konfigurieren). Aktualisieren Sie diese Werte mit dem eigentlichen Bezeichner und der Antwort-URL.

6. Navigieren Sie auf der Seite Einmaliges Anmelden (SSO) mit SAML einrichten im Abschnitt SAML-Signaturzertifikat zum Eintrag Zertifikat (Base64) . Wählen Sie Herunterladen aus, um das Zertifikat herunterzuladen, und speichern Sie es auf Ihrem Computer.

   

7. Kopieren Sie im Abschnitt Coda einrichten die entsprechenden URLs basierend auf Ihren Anforderungen.

   

Erstellen einer Microsoft Entra-Testbenutzerin

In diesem Abschnitt erstellen Sie einen Testbenutzer mit dem Namen B. Simon.

1. Melden Sie sich beim Microsoft Entra Admin Center mindestens als Benutzeradministrator an.
2. Browsen Sie zu Identität>Benutzer>Alle Benutzer.
3. Wählen Sie oben auf dem Bildschirm Neuer Benutzer>Neuen Benutzer erstellen aus.
4. Führen Sie unter den Eigenschaften für Benutzer die folgenden Schritte aus:
   1. Geben Sie im Feld Anzeigename den Namen B.Simon ein.
   2. Geben Sie im Feld Benutzerprinzipalname ein username@companydomain.extension. Beispiel: B.Simon@contoso.com.
   3. Aktivieren Sie das Kontrollkästchen Kennwort anzeigen, und notieren Sie sich den Wert aus dem Feld Kennwort.
   4. Klicken Sie auf Überprüfen + erstellen.
5. Klicken Sie auf Erstellen.

Zuweisen der Microsoft Entra-Testbenutzerin

In diesem Abschnitt ermöglichen Sie B.Simon die Verwendung des einmaligen Anmeldens, indem Sie ihr Zugriff auf Coda gewähren.

1. Melden Sie sich beim Microsoft Entra Admin Center mindestens als Cloudanwendungsadministrator an.
2. Navigieren Sie zu Identität>Anwendungen>Unternehmensanwendungen>Coda.
3. Navigieren Sie auf der Übersichtsseite der App zum Abschnitt Verwalten, und wählen Sie Benutzer und Gruppen aus.
4. Wählen Sie Benutzer hinzufügen und anschließend im Dialogfeld Zuweisung hinzufügen die Option Benutzer und Gruppen aus.
5. Wählen Sie im Dialogfeld Benutzer und Gruppen in der Liste „Benutzer“ den Eintrag B. Simon aus, und klicken Sie dann unten auf dem Bildschirm auf die Schaltfläche Auswählen.
6. Wenn Sie einen beliebigen Rollenwert in der SAML-Assertion erwarten, wählen Sie im Dialogfeld Rolle auswählen die entsprechende Rolle für den Benutzer in der Liste aus, und klicken Sie dann im unteren Bildschirmbereich auf die Schaltfläche Auswählen.
7. Klicken Sie im Dialogfeld Zuweisung hinzufügen auf die Schaltfläche Zuweisen.

Konfigurieren des einmaligen Anmeldens für Coda

Geben Sie zum Abschließen des Setups Werte von Microsoft Entra ID im Coda-Panel Configure Saml (SAML konfigurieren) ein.

1. Öffnen Sie in Coda das Panel Organization settings (Organisationseinstellungen).
2. Aktivieren Sie unter Authenticate with SSO (SAML) (Authentifizieren mit SSO (SAML)) die Option Configure SAML (SAML konfigurieren).
3. Legen Sie SAML-Anbieter auf Microsoft Entra ID fest.
4. Fügen Sie unter Identity Provider Login URL (Anmelde-URL des Identitätsanbieters) die Anmelde-URL aus der Azure-Konsole ein.
5. Fügen Sie unter Identity Provider Issuer (Aussteller des Identitätsanbieters) den Microsoft Entra-Bezeichner aus der Azure-Konsole ein.
6. Wählen Sie unter Identity Provider Public Certificate (Öffentliches Zertifikat des Identitätsanbieters) die Option Upload Certificate (Zertifikat hochladen) und dann die zuvor heruntergeladene Zertifikatdatei aus.
7. Wählen Sie Speichern aus.

Damit ist das Setup der SAML-SSO-Verbindung abgeschlossen.

Erstellen eines Coda-Testbenutzers

In diesem Abschnitt wird in Coda ein Benutzer mit dem Namen Britta Simon erstellt. Coda unterstützt die Just-in-Time-Benutzerbereitstellung (standardmäßig aktiviert). Für Sie steht in diesem Abschnitt kein Aktionselement zur Verfügung. Ist ein Benutzer noch nicht in Coda vorhanden, wird nach der Authentifizierung ein neuer Benutzer erstellt.

Außerdem unterstützt Coda die automatische Benutzerbereitstellung. Weitere Informationen zum Konfigurieren der automatischen Benutzerbereitstellung finden Sie hier.

Testen des einmaligen Anmeldens

In diesem Abschnitt testen Sie die Microsoft Entra-Konfiguration für einmaliges Anmelden mit den folgenden Optionen.

• Klicken Sie auf Diese Anwendung testen. Dadurch sollten Sie automatisch bei der Coda-Instanz angemeldet werden, für die Sie einmaliges Anmelden eingerichtet haben.

• Sie können „Meine Apps“ von Microsoft verwenden. Wenn Sie in „Meine Apps“ auf die Kachel „Coda“ klicken, sollten Sie automatisch bei der Coda-Instanz angemeldet werden, für die Sie einmaliges Anmelden eingerichtet haben. Weitere Informationen zu „Meine Apps“ finden Sie in dieser Einführung.

Nächste Schritte

Nach dem Konfigurieren von Coda können Sie die Sitzungssteuerung erzwingen, die in Echtzeit vor der Exfiltration und Infiltration vertraulicher Unternehmensdaten schützt. Die Sitzungssteuerung basiert auf bedingtem Zugriff. Erfahren Sie, wie Sie die Sitzungssteuerung mit Microsoft Defender for Cloud Apps erzwingen.