Die soziale Authentifizierung ist ein mehrstufiger Authentifizierungsvorgang, mit dem Sie einen Nutzer in einem Konto anmelden oder mit einem bestehenden Konto verknüpfen können.
Sowohl native Plattformen als auch das Web unterstützen das Erstellen von Anmeldedaten, die dann an die Methoden signInWithCredential oder linkWithCredential übergeben werden können. Alternativ können Sie auf Webplattformen den Authentifizierungsprozess über ein Pop-up oder eine Weiterleitung auslösen.
Die meisten Konfigurationen sind bereits eingerichtet, wenn Sie die Google-Anmeldung mit Firebase verwenden. Sie müssen jedoch dafür sorgen, dass der SHA1-Schlüssel Ihres Computers für die Verwendung mit Android konfiguriert wurde. Informationen zum Generieren des Schlüssels finden Sie in der Authentifizierungsdokumentation.
Prüfen Sie, ob der Anmeldeanbieter „Google“ in der Firebase Console aktiviert ist.
Wenn sich Ihr Nutzer mit Google anmeldet, nachdem er bereits ein Konto manuell registriert hat, wird sein Authentifizierungsanbieter aufgrund des Konzepts der vertrauenswürdigen Anbieter von Firebase Authentication automatisch zu Google geändert. Weitere Informationen
iOS+ und Android
Auf nativen Plattformen ist eine Drittanbieterbibliothek erforderlich, um den Authentifizierungsablauf auszulösen.
Installieren Sie das offizielle google_sign_in-Plug-in.
Nach der Installation starten Sie den Anmeldevorgang und erstellen Sie einen neuen Berechtigungsnachweis:
import 'package:google_sign_in/google_sign_in.dart';
Future<UserCredential> signInWithGoogle() async {
// Trigger the authentication flow
final GoogleSignInAccount? googleUser = await GoogleSignIn.instance.authenticate();
// Obtain the auth details from the request
final GoogleSignInAuthentication googleAuth = googleUser.authentication;
// Create a new credential
final credential = GoogleAuthProvider.credential(idToken: googleAuth.idToken);
// Once signed in, return the UserCredential
return await FirebaseAuth.instance.signInWithCredential(credential);
}
Web
Im Web unterstützt das Firebase SDK die automatische Verarbeitung des Authentifizierungsablaufs über Ihr Firebase-Projekt. Beispiel:
Erstellen Sie einen Google-Authentifizierungsanbieter und geben Sie alle zusätzlichen Berechtigungsbereiche an, die Sie vom Nutzer erhalten möchten:
GoogleAuthProvider googleProvider = GoogleAuthProvider();
googleProvider.addScope('https://www.googleapis.com/auth/contacts.readonly');
googleProvider.setCustomParameters({
'login_hint': 'user@example.com'
});
Geben Sie die Anmeldedaten für die Methode signInWithPopup an. Dadurch wird ein neues Fenster geöffnet, in dem der Nutzer aufgefordert wird, sich in Ihrem Projekt anzumelden. Alternativ können Sie signInWithRedirect verwenden, um den Authentifizierungsprozess im selben Fenster zu belassen.
Future<UserCredential> signInWithGoogle() async {
// Create a new provider
GoogleAuthProvider googleProvider = GoogleAuthProvider();
googleProvider.addScope('https://www.googleapis.com/auth/contacts.readonly');
googleProvider.setCustomParameters({
'login_hint': 'user@example.com'
});
// Once signed in, return the UserCredential
return await FirebaseAuth.instance.signInWithPopup(googleProvider);
// Or use signInWithRedirect
// return await FirebaseAuth.instance.signInWithRedirect(googleProvider);
}
Google Play Spiele (nur Android)
Achten Sie darauf, dass der Anmeldeanbieter „Play Spiele“ in der Firebase Console aktiviert ist. Folgen Sie dieser Anleitung, um ein Firebase-Projekt für Play Spiele einzurichten.
Folgen Sie dieser Anleitung, um Play-Spieldienste mit Ihrer Firebase-App zu konfigurieren.
Android
Future<void> _signInWithPlayGames() async {
// Get server auth code from 3rd party provider
// See PR description for details on how you might get the server auth code:
// https://github.com/firebase/flutterfire/pull/12201#issue-2100392487
final serverAuthCode = '...';
final playGamesCredential = PlayGamesAuthProvider.credential(
serverAuthCode: serverAuthCode);
await FirebaseAuth.instance
.signInWithCredential(playGamesCredential);
}
Bevor Sie beginnen, richten Sie Ihre Facebook-Entwickler-App ein und folgen Sie der Anleitung, um die Facebook-Anmeldung zu aktivieren.
Achten Sie darauf, dass der Anmeldeanbieter „Facebook“ in der Firebase Console aktiviert ist und die Facebook-App-ID und das Secret festgelegt sind.
iOS+ und Android
Auf nativen Plattformen ist eine Drittanbieterbibliothek erforderlich, um das Facebook-SDK zu installieren und den Authentifizierungsablauf auszulösen.
Installieren Sie das flutter_facebook_auth-Plug-in.
Sie müssen die Schritte in der Plug-in-Dokumentation ausführen, um sicherzustellen, dass sowohl das Android- als auch das iOS-Facebook-SDK richtig initialisiert wurden. Lösen Sie nach Abschluss den Anmeldevorgang aus, erstellen Sie Anmeldedaten für Facebook und melden Sie den Nutzer an:
import 'package:flutter_facebook_auth/flutter_facebook_auth.dart';
Future<UserCredential> signInWithFacebook() async {
// Trigger the sign-in flow
final LoginResult loginResult = await FacebookAuth.instance.login();
// Create a credential from the access token
final OAuthCredential facebookAuthCredential = FacebookAuthProvider.credential(loginResult.accessToken.token);
// Once signed in, return the UserCredential
return FirebaseAuth.instance.signInWithCredential(facebookAuthCredential);
}
Web
Im Web unterstützt das Firebase SDK die automatische Verarbeitung des Authentifizierungsablaufs mithilfe der in der Firebase-Konsole angegebenen Facebook-Anwendungsdetails. Beispiel:
Erstellen Sie einen Facebook-Anbieter und geben Sie alle zusätzlichen Bereichsberechtigungen an, die Sie vom Nutzer erhalten möchten.
Achten Sie darauf, dass der OAuth-Weiterleitungs-URI aus der Firebase Console als gültiger OAuth-Weiterleitungs-URI in Ihrer Facebook-App hinzugefügt wird.
FacebookAuthProvider facebookProvider = FacebookAuthProvider();
facebookProvider.addScope('email');
facebookProvider.setCustomParameters({
'display': 'popup',
});
Geben Sie die Anmeldedaten für die Methode signInWithPopup an. Dadurch wird ein neues Fenster geöffnet, in dem der Nutzer aufgefordert wird, sich in Ihrer Facebook-Anwendung anzumelden:
Future<UserCredential> signInWithFacebook() async {
// Create a new provider
FacebookAuthProvider facebookProvider = FacebookAuthProvider();
facebookProvider.addScope('email');
facebookProvider.setCustomParameters({
'display': 'popup',
});
// Once signed in, return the UserCredential
return await FirebaseAuth.instance.signInWithPopup(facebookProvider);
// Or use signInWithRedirect
// return await FirebaseAuth.instance.signInWithRedirect(facebookProvider);
}
Apple
iOS+
Konfigurieren Sie die Anmeldung mit Apple und aktivieren Sie Apple als Anmeldeanbieter, bevor Sie beginnen.
Prüfen Sie als Nächstes, ob Ihre Runner-Apps die Funktion „Über Apple anmelden“ unterstützen.
Android
Konfigurieren Sie die Anmeldung mit Apple und aktivieren Sie Apple als Anmeldeanbieter, bevor Sie beginnen.
Web
Konfigurieren Sie die Anmeldung mit Apple und aktivieren Sie Apple als Anmeldeanbieter, bevor Sie beginnen.
import 'package:firebase_auth/firebase_auth.dart';
Future<UserCredential> signInWithApple() async {
final appleProvider = AppleAuthProvider();
if (kIsWeb) {
await FirebaseAuth.instance.signInWithPopup(appleProvider);
} else {
await FirebaseAuth.instance.signInWithProvider(appleProvider);
}
}
Nur Anmeldung über Apple-Plattform
Die Apple-Anmeldung auf iOS+-Plattformen kann auch mit der folgenden Methode erfolgen:
// Implement a function that generates a nonce. See iOS documentation for how to create a nonce:
// https://firebase.google.com/docs/auth/ios/apple#sign_in_with_apple_and_authenticate_with_firebase
String rawNonce = createNonce();
// Create a SHA-256 hash of the nonce. Consider using the `crypto` package from the pub.dev registry.
String hashSHA256String = createHashSHA256String(rawNonce);
// Use the hash of the nonce to get the idToken. Consider using the `sign_in_with_apple` plugin from the pub.dev registry.
String idToken = await getIdToken();
final fullName = AppleFullPersonName(
familyName: 'Name',
givenName: 'Your',
);
// Use the `rawNonce` and `idToken` to get the credential
final credential = AppleAuthProvider.credentialWithIDToken(
idToken,
rawNonce,
fullName,
);
await FirebaseAuth.instance.signInWithCredential(credential);
Apple-Authentifizierungstokens widerrufen
Bei der Apple-Anmeldung auf Apple-Plattformen wird ein Autorisierungscode zurückgegeben, mit dem das Apple-Authentifizierungstoken über die revokeTokenWithAuthorizationCode() API widerrufen werden kann.
import 'package:firebase_auth/firebase_auth.dart';
Future<UserCredential> signInWithApple() async {
final appleProvider = AppleAuthProvider();
UserCredential userCredential = await FirebaseAuth.instance.signInWithPopup(appleProvider);
// Keep the authorization code returned from Apple platforms
String? authCode = userCredential.additionalUserInfo?.authorizationCode;
// Revoke Apple auth token
await FirebaseAuth.instance.revokeTokenWithAuthorizationCode(authCode!);
}
Apple Game Center (nur Apple)
Achten Sie darauf, dass der Anmeldeanbieter „Game Center“ in der Firebase Console aktiviert ist. Folgen Sie dieser Anleitung zur Einrichtung eines Game Center-Firebase-Projekts.
Sie müssen sich mit Game Center anmelden, bevor Anmeldedaten für Firebase Game Center ausgestellt und über Firebase angemeldet werden können. Hier finden Sie eine Anleitung dazu.
iOS+
Future<void> _signInWithGameCenter() async {
final credential = GameCenterAuthProvider.credential();
await FirebaseAuth.instance
.signInWithCredential(credential);
}
Microsoft
iOS+
Bevor Sie beginnen, konfigurieren Sie die Microsoft-Anmeldung für iOS und fügen Sie die benutzerdefinierten URL-Schemas Ihrem Runner hinzu (Schritt 1).
Android
Konfigurieren Sie die Microsoft-Anmeldung für Android, bevor Sie beginnen.
Vergessen Sie nicht, den SHA-1-Fingerabdruck Ihrer App hinzuzufügen.
Web
Konfigurieren Sie Microsoft Login for Web, bevor Sie beginnen.
import 'package:firebase_auth/firebase_auth.dart';
Future<UserCredential> signInWithMicrosoft() async {
final microsoftProvider = MicrosoftAuthProvider();
if (kIsWeb) {
await FirebaseAuth.instance.signInWithPopup(microsoftProvider);
} else {
await FirebaseAuth.instance.signInWithProvider(microsoftProvider);
}
}
Prüfen Sie, ob der Anmeldeanbieter „Twitter“ in der Firebase Console aktiviert ist und ein API-Schlüssel und ein API-Secret festgelegt sind. Achten Sie darauf, dass der Firebase-OAuth-Weiterleitungs-URI (z.B. my-app-12345.firebaseapp.com/__/auth/handler) in der Konfiguration Ihrer Twitter-App als Autorisierungs-Callback-URL in den Einstellungen Ihrer App festgelegt ist.
Je nach App müssen Sie möglicherweise auch einen erweiterten API-Zugriff beantragen.
iOS+
Sie müssen Ihr benutzerdefiniertes URL-Schema wie in Schritt 1 des iOS-Leitfadens beschrieben konfigurieren.
Android
Wenn Sie den SHA-1-Fingerabdruck Ihrer App noch nicht angegeben haben, können Sie dies in der Firebase Console auf der Seite Einstellungen tun. Weitere Informationen zum Abrufen des SHA-1-Fingerabdrucks Ihrer App finden Sie unter Client authentifizieren.
Web
Funktioniert sofort.
import 'package:firebase_auth/firebase_auth.dart';
Future<void> _signInWithTwitter() async {
TwitterAuthProvider twitterProvider = TwitterAuthProvider();
if (kIsWeb) {
await FirebaseAuth.instance.signInWithPopup(twitterProvider);
} else {
await FirebaseAuth.instance.signInWithProvider(twitterProvider);
}
}
GitHub
Sie müssen eine OAuth-App in Ihren GitHub-Entwicklereinstellungen einrichten und der Anmeldeanbieter „GitHub“ muss in der Firebase-Konsole aktiviert sein. Außerdem müssen die Client-ID und das Secret festgelegt und die Callback-URL in der GitHub-App festgelegt sein.
iOS+ und Android
Bei nativen Plattformen müssen Sie google-services.json und GoogleService-Info.plist hinzufügen.
Fügen Sie für iOS das benutzerdefinierte URL-Schema wie in Schritt 1 des iOS-Leitfadens beschrieben hinzu.
Future<UserCredential> signInWithGitHub() async {
// Create a new provider
GithubAuthProvider githubProvider = GithubAuthProvider();
return await FirebaseAuth.instance.signInWithProvider(githubProvider);
}
Web
Im Web bietet das GitHub SDK Unterstützung für die automatische Verarbeitung des Authentifizierungsablaufs mithilfe der in der Firebase Console angegebenen GitHub-Anwendungsdetails. Achten Sie darauf, dass die Callback-URL in der Firebase Console als Callback-URL in Ihrer GitHub-Anwendung in der Entwicklerkonsole hinzugefügt wird.
Beispiel:
Erstellen Sie einen GitHub-Anbieter und geben Sie die Anmeldedaten für die signInWithPopup-Methode an. Dadurch wird ein neues Fenster geöffnet, in dem der Nutzer aufgefordert wird, sich in Ihrer GitHub-Anwendung anzumelden:
Future<UserCredential> signInWithGitHub() async {
// Create a new provider
GithubAuthProvider githubProvider = GithubAuthProvider();
// Once signed in, return the UserCredential
return await FirebaseAuth.instance.signInWithPopup(githubProvider);
// Or use signInWithRedirect
// return await FirebaseAuth.instance.signInWithRedirect(githubProvider);
}
Yahoo!
Achten Sie darauf, dass der Anmeldeanbieter „Yahoo“ in der Firebase Console aktiviert ist und ein API-Schlüssel und ein API-Secret festgelegt sind. Achten Sie außerdem darauf, dass Ihr Firebase-OAuth-Weiterleitungs-URI (z.B. my-app-12345.firebaseapp.com/__/auth/handler) als Weiterleitungs-URI in der Yahoo Developer Network-Konfiguration Ihrer App festgelegt ist.
iOS+
Konfigurieren Sie Yahoo-Login für iOS und fügen Sie Ihrem Runner die benutzerdefinierten URL-Schemas (Schritt 1) hinzu, bevor Sie beginnen.
Android
Konfigurieren Sie die Yahoo-Anmeldung für Android, bevor Sie beginnen.
Vergessen Sie nicht, den SHA-1-Fingerabdruck Ihrer App hinzuzufügen.
Web
Funktioniert sofort.
import 'package:firebase_auth/firebase_auth.dart';
Future<UserCredential> signInWithYahoo() async {
final yahooProvider = YahooAuthProvider();
if (kIsWeb) {
await _auth.signInWithPopup(yahooProvider);
} else {
await _auth.signInWithProvider(yahooProvider);
}
}
OAuth-Zugriffstoken verwenden
Mit einem AuthProvider können Sie das mit dem Anbieter verknüpfte Zugriffstoken mit der folgenden Anfrage abrufen.
final appleProvider = AppleAuthProvider();
final user = await FirebaseAuth.instance.signInWithProvider(appleProvider);
final accessToken = user.credential?.accessToken;
// You can send requests with the `accessToken`
Authentifizierungsanbieter verknüpfen
Wenn Sie einen Anbieter mit einem aktuellen Nutzer verknüpfen möchten, können Sie die folgende Methode verwenden:
await FirebaseAuth.instance.signInAnonymously();
final appleProvider = AppleAuthProvider();
if (kIsWeb) {
await FirebaseAuth.instance.currentUser?.linkWithPopup(appleProvider);
// You can also use `linkWithRedirect`
} else {
await FirebaseAuth.instance.currentUser?.linkWithProvider(appleProvider);
}
// You're anonymous user is now upgraded to be able to connect with Sign In With Apple
Nochmalige Authentifizierung beim Anbieter
Dasselbe Muster kann mit reauthenticateWithProvider verwendet werden, um neue Anmeldedaten für vertrauliche Vorgänge abzurufen, die eine aktuelle Anmeldung erfordern.
final appleProvider = AppleAuthProvider();
if (kIsWeb) {
await FirebaseAuth.instance.currentUser?.reauthenticateWithPopup(appleProvider);
// Or you can reauthenticate with a redirection
// await FirebaseAuth.instance.currentUser?.reauthenticateWithRedirect(appleProvider);
} else {
await FirebaseAuth.instance.currentUser?.reauthenticateWithProvider(appleProvider);
}
// You can now perform sensitive operations