Überblick
Die verfügbaren Integrationen für Fieldwire umfassen einen Grundpfeiler der Benutzerverwaltung für mittlere bis größere Unternehmen: Microsoft Entra ID. Mit dieser zuvor als Microsoft Azure AD bekannten Funktion können Benutzer, die ein Business- und Business Plus-Abonnement besitzen, eine Benutzergruppe, die in Entra ID vorhanden ist, direkt mit Fieldwire synchronisieren.
Hinweis: Noch sind die Screenshots in diesem Artikel auf Englisch, sie werden jedoch in Kürze aktualisiert.
Inhaltsverzeichnis
- Verbinden von Entra ID und Aktivieren der Automatisierung
- Hinzufügen von Benutzern im Admin Center von Microsoft Entra
-
FAQs
Verbinden von Entra ID und Aktivieren der Automatisierung
Um Ihr Entra ID-Konto zu verbinden, müssen Sie die notwendigen Freigaben einrichten, damit die Automatisierung korrekt funktioniert. (Hierzu müssen Sie ein Kontoverwalter in Fieldwire sein.)
Der folgende Prozess ist sehr detailliert und sehr spezifisch. Deshalb haben wir viele Screenshots eingefügt. Nehmen Sie sich Zeit, um jeden Schritt genau zu befolgen.
Klicken Sie in der Registerkarte „Integrationen“ Ihres Fieldwire-Kontos auf „Microsoft Entra ID“.
Wählen Sie die Schaltfläche „Microsoft Entra ID-Konto verbinden“. Geben Sie im sich öffnenden Dialogfenster den Namen des Kontos ein, mit dem Sie sich verbinden möchten. Klicken Sie dann auf „Weiter“.
Das Dialogfenster wird erweitert und zeigt 3 erforderliche Felder an: „Client-ID“, „Client-Geheimnis“ und „Mandant“.
Folgen Sie den Anweisungen unter jedem Feld, um die Informationen aus dem Azure-Portal abzurufen und in Fieldwire einzugeben. Gehen Sie zunächst zum Azure-Portal > App-Registrierungen > Neue Registrierung >. Füllen Sie den Abschnitt „Eine Anwendung registrieren“ für Fieldwire aus. Dabei werden die Informationen, die Sie für die Felder „Client ID“ und „Mandant“ benötigen, automatisch generiert.
Hier sehen Sie ein Beispiel, wie Sie die Seite „Eine Anwendung registrieren“ ausfüllen müssen:
Die Fieldwire-App ist jetzt registriert. Sie können die Anwendungs-ID (Client) und die Verzeichnis-ID (Mandant) kopieren und in die Pflichtfelder des Dialogfensters „Ihr Microsoft Entra ID-Konto verbinden“ einfügen.
Bevor Sie das „Client-Geheimnis“ erhalten, gehen Sie zurück zum Azure-Portal und wählen Sie API-Freigaben > Eine Freigabe hinzufügen.
Wählen Sie in dem Dialogfenster, das sich daraufhin öffnet, „Microsoft Graph“ und dann „Anwendungsfreigaben“.
Geben Sie „user.read.all“ in die Suchleiste ein. Aktivieren Sie das Kästchen neben dieser Freigabe und klicken Sie unten im Dialogfenster auf „Freigaben hinzufügen“.
Wiederholen Sie den Vorgang, um die Freigabe „Group.Read.Al“ hinzuzufügen:
An dieser Stelle können Sie die konfigurierten Freigaben überprüfen. Wenn „User.Read“ vorhanden ist, klicken Sie rechts auf die drei Punkte. Sie sehen eine Option zum Entfernen dieser Freigabe. Entfernen Sie sie.
Klicken Sie nun auf die Schaltfläche „Admin-Zustimmung für Fieldwire erteilen“:
Klicken Sie im Bestätigungs-Pop-up auf „Ja“.
Wenn die Admin-Zustimmung erfolgreich war, fahren Sie mit dem nächsten Schritt fort, der Erstellung des „Client-Geheimnis“. Der Vorgang ähnelt dem für die API-Freigaben oben. Gehen Sie auf die Registerkarte „Zertifikate & Geheimnisse“ und klicken dann auf „Neues Client-Geheimnis“.
Hier ist ein Beispiel für diese Einrichtung:
Jetzt können Sie den generierten Wert (nicht die ID) kopieren und in das Feld „Client-Geheimnis“ des Dialogfensters in Fieldwire einfügen. Die Zeichen werden nach dem Einfügen unkenntlich gemacht.
Klicken Sie auf „Verbinden“.
Wenn die Verbindung erfolgreich ist, erhalten Sie eine Bestätigung. Sie sehen zudem eine Option, um die Verbindung zu trennen, falls dies in Zukunft erforderlich sein sollte.
Klicken Sie auf der Registerkarte „Entra ID-Integration“ auf „Gruppe auswählen“ und wählen Sie die Benutzergruppe, die Sie mit Fieldwire synchronisieren möchten.
Sie erhalten eine Bestätigung, dass Microsoft Entra ID verbunden und die Automatisierung konfiguriert ist. Herzlichen Glückwunsch, der anspruchsvolle Teil des Prozesses ist abgeschlossen!
Hinzufügen von Benutzern im Admin Center von Microsoft Entra
Ihr Konto ist jetzt verbunden und die Automatisierung ist eingerichtet. Nun müssen Sie Benutzer zur gewählten Entra ID-Gruppe hinzufügen, damit sie automatisch mit Fieldwire synchronisiert werden können. Beachten Sie, dass Benutzer, die bereits in dieser Gruppe waren, bevor diese Automatisierung aktiviert wurde, nicht automatisch synchronisiert werden. Fügen Sie diese Benutzer bei Bedarf erneut hinzu.
Gehen Sie im Microsoft Entra Admin Center auf die Registerkarte „Alle Gruppen“. Wählen Sie dann die Gruppe, die Sie für die Automatisierung ausgewählt haben.
Klicken Sie nun auf die Registerkarte „Mitglieder“ und wählen Sie „+ Mitglieder hinzufügen“.
Ein neues Fenster öffnet sich. Darin können Sie aus einer Liste der in Entra ID vorhandenen Benutzer auswählen. Klicken Sie auf die Kontrollkästchen neben den gewünschten Benutzern und dann auf die Schaltfläche „Auswählen“ unten links.
Sie müssen wahrscheinlich ein paar Mal auf die Schaltfläche „Aktualisieren“ klicken, um die neuen Benutzer zu sehen.
Gehen Sie in der Fieldwire-Web-App auf die Registerkarte „Personen“ auf Kontoebene. Bitte beachten Sie, dass es in der Regel ca. 5 Minuten dauert, bis die Änderungen, die Sie im Entra Admin Center vorgenommen haben, wirksam werden und in Fieldwire angezeigt werden. Wenn Sie die erwarteten Benutzer nach dieser Zeit nicht in Fieldwire sehen, aktualisieren Sie Ihre Website. Dies sollte das Problem beheben.
Hinweis: Standardmäßig haben alle neuen Benutzer, die über diese Integration hinzugefügt werden, die Freigabestufe „Kontobenutzer“. Sie können sie bei Bedarf auf die Stufe „Kontoverwalter“ befördern. (Weitere Informationen zu den Kontofreigabestufen finden Sie hier: Einführung in Kontofreigabestufen: Verwalter, Kontobenutzer und Projektbenutzer).
FAQs
Wie sieht ein typischer Arbeitsablauf für das Benutzer-Onboarding mit dieser Integration aus?
Das folgende Diagramm veranschaulicht den Ablauf:
Abonnements und Rechnungsstellung sind sensible Funktionen. Was kann bei dieser Automatisierung passieren?
Bitte beachten Sie die nachstehende Tabelle:
Aktion | Ergebnis |
Die Automatisierung wird erstellt. | Es werden keine Benutzer automatisch synchronisiert. Bereits vorhandene Entra ID-Benutzer werden nicht hinzugefügt. |
Hinzufügen - Ein Benutzer, der nicht über Fieldwire verfügt, wird in Entra ID hinzugefügt. |
Der Benutzer wird zu Fieldwire als Kontonutzer hinzugefügt. Wir senden die „Willkommen“-E-Mail an ihn. |
Hinzufügen - Ein Fieldwire-Basisbenutzer wird in Entra ID hinzugefügt. | Der Benutzer wird zu diesem Konto als Kontonutzer hinzugefügt. Wir senden die E-Mail „[Person] hat Sie hinzugefügt“. |
Hinzufügen - Ein Fieldwire-Benutzer mit eigenem kostenpflichtigen Abonnement wird zu Entra ID hinzugefügt | Sie werden nicht zum Konto eingeladen (gleiches Verhalten wie bei der Fieldwire-App). |
Hinzufügen - Ein Benutzer wird in Entra ID hinzugefügt, aber das Konto hat ein Benutzerlimit und ist ausgelastet | Sie werden nicht zum Konto eingeladen (gleiches Verhalten wie bei der Fieldwire-App). |
Hinzufügung - Mehr als 100 Benutzer werden in weniger als 24 Stunden hinzugefügt. |
Die ersten 100 Benutzer erhalten ihre „Willkommen“- oder eine „[Person] hat Sie hinzugefügt“-E-Mail. Die übrigen Nutzer erhalten keine E-Mail, da Sie nur 100 bezahlte Nutzer pro Tag zu Ihrem Konto einladen können (gleiches Verhalten wie bei der Fieldwire-App). |
Entfernen - Ein Benutzer wird in Entra ID entfernt. Dieser Benutzer existiert in Fieldwire. | Der Benutzer wird aus diesem Konto und allen Projekten entfernt. |
Löschung - Ein Benutzer wird in Entra ID gelöscht (ohne vorher aus der Gruppe entfernt zu werden) | Der Benutzer wird nicht aus Fieldwire entfernt. |
Eine Benutzer-E-Mail-Adresse wird in Entra ID geändert. | In Fieldwire passiert nichts (wir verfolgen keine E-Mail-Änderungen). |
Muss ich irgendetwas tun, um Zugang zur Entra ID-Funktion zu erhalten?
Wenn Sie ein Business- oder Business Plus-Abonnement haben, erhalten Sie standardmäßig Zugriff auf diese und andere Fieldwire-Integrationen.
Was passiert, wenn ich einen Benutzer aus der ausgewählten Microsoft Entra ID-Gruppe entferne?
Der Benutzer wird auch aus Ihrem Fieldwire-Konto/Ihren Fieldwire-Projekten entfernt.
Kann ich in Fieldwire zusätzlich zu Entra ID weiterhin Benutzer entfernen?
Ja, das können Sie! Hier finden Sie weitere Informationen dazu: Einladen oder Entfernen eines Benutzers aus Konten oder Projekten
Ist diese Integration auf Projektebene in Fieldwire verfügbar?
Nein, sie ist derzeit für die Kontoebene konzipiert.
Ich habe SSO für mein Konto aktiviert. Beschleunigt diese Integration das Hinzufügen von Benutzern zu Fieldwire?
Ja! Zuvor mussten Microsoft Entra ID-Benutzer, die auch SSO aktiviert hatten, einen Prozess aus 3 Schritten befolgen:
1. Hinzufügen von Benutzern zu Entra ID, 2. Anmeldung bei Fieldwire, 3. Manuelles Hinzufügen jedes Benutzers in Fieldwire.
Mit dieser Integration entfallen die Schritte 2 und 3. Sie müssen lediglich Ihre Benutzer in Entra ID hinzufügen (und optional deren Berechtigungsstufe in Fieldwire ändern).
Was passiert, wenn ein Benutzer, den ich zu unserer Entra ID-Gruppe hinzufüge, bereits ein eigenes bezahltes Abonnement hat?
In diesem Fall hat die Automatisierung keine Auswirkungen. Der Benutzer wird nicht zu Ihrem Fieldwire-Konto hinzugefügt. Er muss über folgendes Verfahren manuell zu allen von Ihnen gewählten Projekten eingeladen werden: Einladen oder Entfernen eines Benutzers aus Konten oder Projekten
Was passiert, wenn mein Fieldwire-Abonnement ein Benutzerlimit hat und ich in Entra ID mehr Benutzer hinzufüge als das Benutzerlimit erlaubt?
Sobald das Benutzerlimit erreicht ist, werden keine weiteren Benutzer aus der Entra ID-Gruppe mehr mit Fieldwire synchronisiert.
Ich weiß, dass ich in der Fieldwire-Schnittstelle innerhalb von 24 Stunden bis zu 100 Benutzer zu meinem Konto hinzufügen kann. Gilt das auch für Benutzer, die über Entra ID hinzugefügt werden?
Ja, das Limit gilt auch für die Entra ID-Integration.
Ich habe einen Benutzer in Entra ID gelöscht, aber er wurde nicht aus Fieldwire entfernt. Ist das zu erwarten?
Ja. Sie müssen den Benutzer trotzdem manuell aus der Entra ID-Gruppe entfernen, die mit Fieldwire synchronisiert wird.
Was passiert, wenn die E-Mail-Adresse eines Benutzers in Entra ID aktualisiert wird?
Diese Aktion wird nicht automatisch in Fieldwire übernommen. Der einzelne Benutzer muss die mit seinem Benutzerprofil verknüpfte E-Mail-Adresse durch dieses Verfahren ändern: Q&A: Wie aktualisiere ich meine E-Mail-Adresse und andere Profildaten?
Weitere Informationen
Registerkarte „Integrationen“: Eine Verbindung einrichten
Registerkarte „Integrationen“: Eine Automatisierung einrichten
Registerkarte „Integrationen“: Fehlersuche