So aktivieren Sie die Anmeldung mit Google und Apple

Erfahren Sie, wie Sie Google- und Apple-Entwicklerzugangsdaten vorbereiten, damit sich Ihre Kunden mit ihrem Google- oder Apple-Konto in B2CORE anmelden oder registrieren können

Dieser Leitfaden richtet sich an Broker, die ihren Kunden ermöglichen möchten, sich zusätzlich zu (oder anstelle von) E-Mail und Passwort mit ihrem Google- oder Apple-Konto anzumelden oder zu registrieren. Er erklärt, was Sie auf Ihrer Seite vorbereiten müssen und was geschieht, nachdem Sie die Informationen an B2Broker übermittelt haben.

Dies ist eine gemeinsame Einrichtung: Sie verwalten die Google-/Apple-Entwicklerkonten und Zugangsdaten, B2Broker bindet sie in Ihre B2CORE-Instanz ein. Nichts wird aktiviert, bevor beide Seiten fertig sind.

Für diese Funktion fällt eine einmalige Einrichtungsgebühr an. Wenden Sie sich an Ihren Account Manager oder unser Support-Team, um die Gebühr und Verfügbarkeit zu bestätigen, bevor Sie Zugang anfordern.

Was Sie erhalten

Eine Schaltfläche „Mit Google anmelden“ und/oder „Mit Apple anmelden“ auf Ihren Anmelde- und Registrierungsseiten.
Neue Nutzer, die sich auf diese Weise registrieren, werden automatisch erstellt — ein separates Registrierungsformular ist nicht erforderlich.
Nutzer, die bereits ein Passwortkonto haben, können später auch ein Google-/Apple-Konto verknüpfen (die Verknüpfung erfolgt über die E-Mail-Adresse).

Bevor Sie beginnen

Bestätigen Sie mit Ihrem B2Broker Account Manager, dass die soziale Anmeldung für Ihre B2CORE-Instanz verfügbar ist. Dies setzt voraus, dass Sie bereits die aktuelle Identitätsplattform verwenden.
Entscheiden Sie, welche Anbieter Sie möchten: nur Google, nur Apple oder beide. Apple erfordert ein kostenpflichtiges Apple Developer-Konto, berücksichtigen Sie dies also in Ihrer Planung.
Sie benötigen eine Person auf Ihrer Seite, die Zugriff auf die Google-Cloud-/Apple-Developer-Konten Ihres Unternehmens hat (oder neue Konten erstellen kann).

Was Sie vorbereiten müssen — Google

Ein Google-Cloud-Projekt. Verwenden Sie ein bestehendes Unternehmensprojekt oder erstellen Sie ein neues Projekt speziell für die Anmeldung.
OAuth-Zustimmungsbildschirm. Konfigurieren Sie:
- App-Name, Support-E-Mail, Logo (dies sehen Ihre Nutzer in der Google-Zustimmungsaufforderung).
- Bereiche: openid, email, profile.
- Veröffentlichungsstatus: Solange sich die App im Testing befindet, können sich nur ausdrücklich hinzugefügte Testnutzer anmelden — alle anderen erhalten access_denied. Setzen Sie die App vor dem Go-live auf Published.
Eine OAuth 2.0 Client ID (Anwendungstyp: Web application).
- Wir geben Ihnen die genaue Authorized redirect URI, die Sie registrieren müssen — sie ist an den Hostnamen Ihrer B2CORE-Instanz gebunden und sieht wie folgt aus:
```
https://<your-api-host>/srvsz/auth/clients/v1/self-service/methods/oidc/callback/google
```
- Fügen Sie denselben Host (ohne Pfad) als Authorized JavaScript origin hinzu.
Kopieren Sie die resultierende Client ID und das Client secret.

Was Sie vorbereiten müssen — Apple

Die Apple-Einrichtung umfasst mehr Komponenten und erfordert eine aktive Mitgliedschaft im Apple Developer Program.

Eine App ID mit aktivierter Sign In with Apple-Funktion (verwenden Sie eine bestehende App ID erneut, falls vorhanden, oder erstellen Sie eine neue).
Eine Services ID — dies ist der tatsächliche OAuth-Client, den Apple verwendet. Konfigurieren Sie Folgendes:
- Domain: der API-Host Ihrer B2CORE-Instanz (ohne Schema, ohne Pfad).
- Return URL: die Apple-Callback-URL, die wir bereitstellen, im gleichen Format wie die oben genannte Google-URL, jedoch mit /apple am Ende.
Ein privater Schlüssel für „Sign in with Apple“ (.p8-Datei), der im Bereich Keys von Apple generiert wurde und dessen Sign In with Apple-Funktion mit Ihrer App ID verknüpft ist.

Diese Datei kann nur einmal heruntergeladen werden — speichern Sie sie sofort an einem sicheren Ort.

Ihre Team ID (10 alphanumerische Zeichen, angezeigt in der Kopfzeile Ihres Apple Developer-Kontos).
Die Key ID des in Schritt 3 erstellten Schlüssels.

Sie erhalten fünf Informationen: Services ID (Client ID), Team ID, Key ID, die private Schlüsseldatei .p8 und — anders als bei Google — kein separates „Client secret“, das kopiert werden muss; das Apple-Secret wird aus den anderen vier Angaben abgeleitet.

Zugangsdaten an B2Broker übermitteln

Senden Sie uns:

Google: Client ID + Client secret.
Apple: Services ID, Team ID, Key ID und die private Schlüsseldatei .p8.

Behandeln Sie diese als Geheimnisse — insbesondere den privaten Apple-Schlüssel. Senden Sie sie über einen sicheren Kanal, den Ihr Account Manager bereitstellt (einen Link zur sicheren Geheimnisfreigabe oder einen verschlüsselten Anhang), nicht per unverschlüsselter E-Mail oder Chat. Wir bestätigen Ihnen, sobald sie auf unserer Seite sicher gespeichert sind, und informieren Sie, wenn die Schaltflächen aktiv sind.

Was als Nächstes geschieht

Sobald wir Ihre Zugangsdaten erhalten haben, aktivieren wir die Funktion auf Ihrer B2CORE-Instanz und führen die Bereitstellung durch.

Dies führt in der Regel zu einem kurzen Neustart des Anmeldedienstes — es wird keine Ausfallzeit erwartet, planen Sie dies jedoch nicht während Spitzenzeiten ein.

Tests nach dem Go-live

Öffnen Sie Ihre Anmeldeseite — Sie sollten die Google-/Apple-Schaltfläche(n) sehen.
Melden Sie sich für jeden aktivierten Anbieter mit einem echten Konto an.
Bestätigen Sie, dass der Nutzer angemeldet wird und E-Mail-Adresse/Name in Ihrem Admin-Panel korrekt angezeigt werden.
Wenn sich Google noch im Testing-Modus befindet, können sich nur die Testnutzer anmelden, die Sie zum Zustimmungsbildschirm hinzugefügt haben — alle anderen sehen access_denied. Veröffentlichen Sie die App, bevor Sie die Funktion echten Nutzern anbieten.

Gut zu wissen

Apple teilt den Namen und die E-Mail-Adresse eines Nutzers nur bei dessen allererster Zustimmung mit. Wenn ein Nutzer Ihre App in seinen Apple-ID-Einstellungen widerruft und sich später erneut anmeldet, sendet Apple nur eine anonyme Kennung zurück — der Name kann ab diesem Zeitpunkt fehlen. Dies ist eine Einschränkung von Apple und kein Fehler auf unserer Seite.

Apple-E-Mail-Adressen können „Private Relay“-Adressen sein (...@privaterelay.appleid.com). Dies sind echte, funktionierende Adressen — sie werden lediglich über Apple weitergeleitet. Behandeln Sie sie als die maßgebliche E-Mail-Adresse des Nutzers; sie werden nicht automatisch mit einem bestehenden Passwortkonto abgeglichen, das die tatsächliche E-Mail-Adresse des Nutzers verwendet hat.

Google erfordert eine verifizierte E-Mail-Adresse. Wenn die E-Mail-Adresse eines Google-Kontos nicht verifiziert ist, schlägt die Anmeldung absichtlich fehl — dies schützt Ihre Nutzerbasis vor nicht verifizierten Identitäten.

Anbieter-IDs sind festgelegt (google, apple). Falls Sie jemals Zugangsdaten rotieren müssen (beispielsweise wegen eines offengelegten Secrets), wenden Sie sich an B2Broker — wir können sie aktualisieren, ohne die Anmelde-URLs zu ändern, die Ihre Nutzer bereits verwenden.

Fragen / Support

Wenden Sie sich mit Ihrem Broker-Namen und den Anbieter(n), die Sie einrichten, an Ihren B2Broker Account Manager oder Support-Kanal.

So aktivieren Sie die Anmeldung mit Google und Apple

Auf dieser Seite