OAuth-basierte App-Flip-Verknüpfung (App Flip) öffnet Ihre iOS-App über eine Google-App. damit Nutzer der Google App ihr Konto leichter verknüpfen können. Sie müssen kleinere Codeänderungen an Ihrer iOS-App vornehmen, um diese Funktion zu implementieren.
In diesem Dokument erfahren Sie, wie Sie Ihre iOS-App so ändern, dass sie App Flip unterstützt.
Beispiel testen
Beispiel-App „App Flip“ zeigt eine Kontoverknüpfungsintegration unter iOS, die mit App Flip kompatibel ist. Mit dieser App kannst du prüfen, wie du auf eingehende App Flip universelle Antworten von mobilen Google-Apps aus.
Die Beispiel-App ist für die Integration mit dem App Flip-Testtool für iOS vorkonfiguriert. Mit diesem Tool können Sie die Integration Ihrer iOS-App mit App Flip prüfen, bevor Sie die Kontoverknüpfung mit Google konfigurieren. Diese App simuliert den universellen Link wird von mobilen Google-Apps ausgelöst, wenn App Flip aktiviert ist.
Funktionsweise
Im Folgenden finden Sie die Schritte, die in der Google App und in Ihrer App ausgeführt werden, wenn App-Flip:
Die Google App versucht, den universellen Link Ihrer App zu öffnen. Sie kann Ihre App öffnen, wenn sie auf dem Gerät des Nutzers installiert und mit den universellen Link. Weitere Informationen finden Sie unter Unterstützen von universellen Links.
Deine App prüft, ob die Parameter
client_idundredirect_uricodiert sind in der eingehenden URL mit dem erwarteten universellen Google-Link übereinstimmt.Ihre Anwendung fordert einen Autorisierungscode von Ihrem OAuth2-Server an. Am Ende dieses Vorgangs gibt Ihre Anwendung entweder einen Autorisierungscode oder einen Fehler an der Google App. Dazu wird der universelle Link von Google mit angehängten -Parameter für den Autorisierungscode oder -fehler.
Die Google App verarbeitet den eingehenden universellen Google-Link und fährt mit dem Rest des Ablaufs fort. Wenn ein Autorisierungscode angegeben wird, wird die Verknüpfung sofort abgeschlossen. Der Tokenaustausch erfolgt Server-zu-Server. wie im browserbasierten OAuth-Verknüpfungsvorgang. Wenn ein Fehlercode zurückgegeben wird, wird der Verknüpfungsvorgang mit den alternativen Optionen fortgesetzt.
iOS-App für App Flip anpassen
Nehmen Sie die folgenden Codeänderungen an Ihrer iOS-App vor, um App-Flip zu unterstützen:
- Verarbeiten Sie
NSUserActivityTypeBrowsingWebin Ihrem App Delegate. - Erfassen Sie die Parameter
redirect_uriundstateaus der URL, um sie später zu verwenden. redirect_urimuss folgendes Format haben:https://oauth-redirect.googleusercontent.com/a/GOOGLE_APP_BUNDLE_ID https://oauth-redirect-sandbox.googleusercontent.com/a/GOOGLE_APP_BUNDLE_ID
Prüfen Sie, ob die Client-ID mit dem erwarteten Wert übereinstimmt. Verwenden Sie das folgende Codebeispiel:
func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([Any]?) -> Void) -> Bool { guard userActivity.activityType == NSUserActivityTypeBrowsingWeb, let incomingURL = userActivity.webpageURL, let components = URLComponents(url: incomingURL, resolvingAgainstBaseURL: false), let params = components.queryItems else { return false } if let clientId = params.filter({$0.name == "client_id"}).first?.value, let state = params.filter({$0.name == "state"}).first?.value, let redirectUri = params.filter({$0.name == "redirect_uri"}).first?.value { // Save the redirect_uri and state for later... // Verify the client id return (clientId == GOOGLE_CLIENT_ID) } else { // Missing required parameters return false } }Rufen Sie nach erfolgreicher Autorisierung den Weiterleitungs-URI mit der Autorisierung auf. Code. Verwenden Sie das folgende Codebeispiel:
func returnAuthCode(code: String, state: String, redirectUri: String) { var redirectURL = URL(string: redirectUri) var components = URLComponents(url: redirectURL, resolvingAgainstBaseURL: false) // Return the authorization code and original state let paramAuthCode = URLQueryItem(name: "code", value: code) let paramState = URLQueryItem(name: "state", value: state) components?.queryItems = [paramAuthCode, paramState] if let resultURL = components?.url { UIApplication.shared.open( resultURL, options: [UIApplicationOpenURLOptionUniversalLinksOnly : true], completionHandler: nil) } }Wenn ein Fehler aufgetreten ist, hängen Sie stattdessen ein Fehlerergebnis an den Weiterleitungs-URI an. Verwenden Sie das folgende Codebeispiel:
func returnError(redirectUri: String) { var redirectURL = URL(string: redirectUri) var components = URLComponents(url: redirectURL, resolvingAgainstBaseURL: false) // Return the authorization code and original state let paramError = URLQueryItem(name: "error", value: "invalid_request") let paramDescription = URLQueryItem(name: "error_description", value: "Invalid Request") components?.queryItems = [paramError, paramDescription] if let resultURL = components?.url { UIApplication.shared.open( resultURL, options: [UIApplicationOpenURLOptionUniversalLinksOnly : true], completionHandler: nil) } }
Suchparameter für den universellen Link Ihrer App
Wenn der Universallink Ihrer App über die Google App geöffnet wird, enthält er die folgenden Abfrageparameter:
client_id(String): Googleclient_id, das unter deiner App registriert ist.scope(List of String): Eine Liste der durch Leerzeichen getrennten Bereiche, die angefordert wurden.state(String): Eine von Google verwendete Einmalanfrage, mit der überprüft wird, ob das Autorisierungsergebnis eine Antwort auf die ausgehende Anfrage von Google ist.redirect_uri(String): Universeller Link von Google. Die „Flip“-URI, um die Google App zu öffnen und Ergebnisse zu übergeben.
Suchparameter für den universellen Link von Google
Parameter, die verwendet werden, wenn das Autorisierungsergebnis erfolgreich zurückgegeben wird:
code(String): Der Wert des Autorisierungscodes, falls verfügbar.state(String): Der genaue Wert, der vom eingehenden universellen Link empfangen wird.
Parameter, die verwendet werden, wenn das Autorisierungsergebnis nicht zurückgegeben wird:
error(String) mit den folgenden Werten:cancelled: Ein behebbarer Fehler. Die Google App versucht, dein Konto über die Autorisierungs-URL verknüpft werden. Ein Beispiel dafür sind Fehler, wenn ein Gerät offline ist oder die Verbindung abbricht.unrecoverable: Ein nicht behebbarer Fehler. Beispiel: Der Nutzer versucht, eine Verknüpfung mit einem deaktivierten Konto herzustellen. Die Google App bricht die Kontoverknüpfung ab.invalid_request: Die Anfrageparameter sind ungültig oder fehlen. Dies ist ein behebbarer Fehler. Die Google App versucht, die Kontoverknüpfung über die Autorisierungs-URL vorzunehmen.access_denied: Der Nutzer lehnt die Einwilligungsanfrage ab. Dies ist ein nicht behebbarer Fehler. bricht die Google App die Verknüpfung ab.
error_description(String, optional): Eine nutzerfreundliche Fehlermeldung.
Für alle Fehlertypen müssen die Antwortdaten an den angegebenen
REDIRECT_URI, damit das richtige Fallback ausgelöst wird.
Autorisierungsendpunkt für App-Flip ändern
Konfigurieren Sie Ihre Plattform so, dass Anfragen über die App-Flip-Weiterleitungs-URLs von Google akzeptiert werden:
- Google Home App
https://oauth-redirect.googleusercontent.com/a/com.google.Chromecast.dev https://oauth-redirect.googleusercontent.com/a/com.google.Chromecast.enterprise https://oauth-redirect.googleusercontent.com/a/com.google.Chromecast.rc https://oauth-redirect.googleusercontent.com/a/com.google.Chromecast https://oauth-redirect-sandbox.googleusercontent.com/a/com.google.Chromecast.dev https://oauth-redirect-sandbox.googleusercontent.com/a/com.google.Chromecast.enterprise https://oauth-redirect-sandbox.googleusercontent.com/a/com.google.Chromecast.rc https://oauth-redirect-sandbox.googleusercontent.com/a/com.google.Chromecast
- Google Assistant App
https://oauth-redirect.googleusercontent.com/a/com.google.OPA.dev https://oauth-redirect.googleusercontent.com/a/com.google.OPA.enterprise https://oauth-redirect.googleusercontent.com/a/com.google.OPA.rc https://oauth-redirect.googleusercontent.com/a/com.google.OPA https://oauth-redirect-sandbox.googleusercontent.com/a/com.google.OPA.dev https://oauth-redirect-sandbox.googleusercontent.com/a/com.google.OPA.enterprise https://oauth-redirect-sandbox.googleusercontent.com/a/com.google.OPA.rc https://oauth-redirect-sandbox.googleusercontent.com/a/com.google.OPA
Prüfe, ob client_id und die durch den redirect_uri-Parameter angegebene URL
Sie entsprechen den erwarteten Werten, wenn eine Anfrage eingeht. wenn die Überprüfung durch den Kunden
schlägt er fehl, wird der Fehler invalid_request an redirect_uri zurückgegeben.