@amazon-devices/simplesignin

"@amazon-devices/simplesignin": "~1.1.3",

[[wants.module]]
id = "/com.amazon.dms.ssi@ISimpleSignIn"

[[wants.service]]
id = "com.amazon.dms.ssi.service"

[[wants.interactive]]
id = "com.amazon.dms.ssi.loginselection"

[[wants.interactive]]
id = "com.amazon.dms.ssi.consent"

let promise = SimpleSignInService.getUserAndLinks(IDP_NAME);
promise.then(
    (response) => {
        // Handle response
    }
);

let promise = SimpleSignInService.linkUserAccount(request);
promise.then(
    (response) => {
        // Handle response
    }
);

let promise = SimpleSignInService.showLoginSelection(request);
promise.then(
    (response) => {
        // Handle response
    }
);

let request = {
    ssiEvent: SSIEvent.***,
    timestamp : <epoch timestamp in milliseconds>,
    failureReason = <FailureReason.***>    // If SSIEvent is a Failure, then this field is mandatory.
};

let promise = SimpleSignInService.recordMetricEvent(request);
promise.then((response) => {
    // Usually nothing to handle in this API.
});

let getUserAndLinksPromise = SimpleSignInService.getUserAndLinks(IDP_NAME);  // Calls the API
getUserAndLinksPromise.then(                                                 // Handle response
    (response) => {
        if (response.requestStatus != RequestStatus.SUCCESSFUL) {
            // Check the requestStatus.
            // Example, request is unsuccessul because user has disable Simple Sign-In for their account or this device or for this app.

            // Fallback to show standard login of your app
        } else if (response.links?.length! > 0) {
            // It means there are links present using which user can login

            /*
             * Prepeare to ShowLoginSelection.
             * This code is your customised code. You need to get the
             * login names to show for each link to the user.
             * You can the get the login names from the your server.
             */
            let request:LoginNameValue[] = [];
            response.links?.forEach((link) => {
              request.push({loginName: <login-name-for-the-link>, linkId: link.linkId});
            });

            // Call ShowLoginSelection API
            let showLoginSelectionPromise = SimpleSignInService.showLoginSelection(request);
            showLoginSelectionPromise.then((response) => { // Handle what user has selected
                if (response.userSelection == UserSelection.MANUAL_SIGN_IN) {  // User selected to login with a new account
                    // Show your app's standard login
                } else if (response.userSelection == UserSelection.LOGIN_SELECTED) {  // User selected an existing link to login
                    // Pass the link id to appropriate method or to your app's server to authenticate
                } else {
                    // Means user hasn't selected anything for 15mins, or there was a failure in request
                    // Fallback to show standard login of your app
                }
            });
        } else {
            // It means there are no links created yet for the user
            // Fallback to show standard login of your app
        }
    }
);

let request = {
    partnerUserId: <partnerUserId>,
    identityProviderName: <IDP_NAME>,
    userLoginName: <login-name-for-the-user-account-to-show-to-user>,
    linkToken: {
        token: <token-that-your-server-has-generated>
        schema: "LINK-TOKEN-1.0"
    },
    linkSigningKey: <link-signing-key-that-your-server-generated>
};

// Call LinkUserAccount API
let promise = SimpleSignInService.linkUserAccount(request);
promise.then((response) => {  // Handle response
    if (response.successCode == LinkAccountSuccessCode.LINK_ESTABLISHED) {
        // Save the link id returned in the response corresponding the your app's user account on server.
        // Use `response.linkId`.
    } else if (response.successCode == LinkAccountSuccessCode.LINK_ALREADY_EXISTS) {
        // Save the link id returned in the response corresponding the your app's user account on server as this is new link created.
        // Use `response.linkId`.
    } else if (response.successCode != LinkAccountSuccessCode.CONSENT_DENIED) {
        // Means user doesn't want to link this account.
        // Nothing to do at this point. Proceed with after login process of your app.
    } else {
        // There was some error from Simple Sign-In service. Check the requestStatus
        // and report to Amazon if issue persists.
    }
});

    [[wants.module]]
    id = "/com.amazon.dms.ssi@ISimpleSignIn"

    [[wants.service]]
    id = "com.amazon.dms.ssi.service"

    [[wants.interactive]]
    id = "com.amazon.dms.ssi.loginselection"

    [[wants.interactive]]
    id = "com.amazon.dms.ssi.consent"