Federation with Hosted UI

The easiest way to present users a GUI that includes identity federation is to use Cognito Hosted UI. Cognito Hosted UI automatically adds “Continue With XXX” button based on the backend configuration.

You can test the Hosted UI by clicking on the link given by Amplify CLI at the end of the amplify push command from previous section. For example, my link is:


The Hosted UI now shows the “Login With Facebook” button. federation hosted ui

If you try to authenticate using Facebook using the above URI from a browser, you will be directed to Facebook’s page and be able to enter your email address and password. However the process will not terminate completly as the redirect_uri in the URL is an iOS only URI that we gave for our app (landmarks://) The final redirection will only work in our mobile app.

Let’s update the application code to revert back to the Hosted UI.

In XCode, open Landmarks/LandingView.swift file and paste the below (lines that have been modified are highlighted):

//  LandingView.swift
//  Landmarks

// Landmarks/LandingView.swift

import SwiftUI

struct LandingView: View {
    @ObservedObject public var user : UserData
    var body: some View {
        let loginView = LoginViewController()
        return VStack {
            // .wrappedValue is used to extract the Bool from Binding<Bool> type
            if (!$user.isSignedIn.wrappedValue) {
//                CustomLoginView()
                ZStack {
                   Button(action: { loginView.authenticate() } ) {
            } else {

struct LandingView_Previews: PreviewProvider {
    static var previews: some View {
        let app = UIApplication.shared.delegate as! AppDelegate
        return LandingView(user: app.userData)

The list of changes in the code (including Amplify configuration changes) are visible in this commit.

Build and Test

Build and launch the application to verify everything is working as expected. Click the build icon or press ⌘R. build

If you are still authenticated, click Sign Out and click the user badge to sign in again. You should see the Amazon Cognito hosted UI. Click Continue With Facebook, follow the Facebook login process, including accepting Amplify iOS Workshop app to access your profile data and, eventually, you should see the Landmark list. customized drop in UI

When tapping the User Badge, you might be immediately redirected to the Landmark List. This is because your authentication is cached on the device. The app is using Safari to display the Amazon Cognito Hosted UI and Safari is caching web cookies and other web site data. To force the login screen to appear again, go to the phone Settings => Safari => Clear History and Web Site Data. Then signout the app and tap the User Badge again.

At this stage, no code change is required if you decide to add other identity providers to your backend configuration. The Hosted UI will automatically propose “Login with XXX” buttons based on the providers configured on the backend. All the interactions between the identity provider and Cognito happen on the backend, no client code is involved.

Checking Amazon Cognito Identities

By choosing Continue with Facebook, you actually created a second identity in your backend. As seen from Amazon Cognito, the user you created earlier and the Facebook federated user are two different identities. You can connect to Amazon Cognito console, click on the user pool name (amplifyiosworkshopxxxxx), select User and Groups on the left menu to verify two identities have been created:

cognito identities