開發人員驗證的身分

Android

若要使用開發人員驗證的身分，請實作您自己的身分供應商類別，擴展 AWSAbstractCognitoIdentityProvider。您的身分供應商類別應傳回包含字符做為屬性的回應物件。

下列是基礎身分提供者範例。

public class DeveloperAuthenticationProvider extends AWSAbstractCognitoDeveloperIdentityProvider {

  private static final String developerProvider = "<Developer_provider_name>";

  public DeveloperAuthenticationProvider(String accountId, String identityPoolId, Regions region) {
    super(accountId, identityPoolId, region);
    // Initialize any other objects needed here.
  }

  // Return the developer provider name which you choose while setting up the
  // identity pool in the &COG; Console

  @Override
  public String getProviderName() {
    return developerProvider;
  }

  // Use the refresh method to communicate with your backend to get an
  // identityId and token.

  @Override
  public String refresh() {

    // Override the existing token
    setToken(null);

    // Get the identityId and token by making a call to your backend
    // (Call to your backend)

    // Call the update method with updated identityId and token to make sure
    // these are ready to be used from Credentials Provider.

    update(identityId, token);
    return token;

  }

  // If the app has a valid identityId return it, otherwise get a valid
  // identityId from your backend.

  @Override
  public String getIdentityId() {

    // Load the identityId from the cache
    identityId = cachedIdentityId;

    if (identityId == null) {
       // Call to your backend
    } else {
       return identityId;
    }

  }
}

若要使用此身分提供者，您必須將其傳入 CognitoCachingCredentialsProvider。範例如下：

DeveloperAuthenticationProvider developerProvider = new DeveloperAuthenticationProvider( null, "IDENTITYPOOLID", context, Regions.USEAST1);
CognitoCachingCredentialsProvider credentialsProvider = new CognitoCachingCredentialsProvider( context, developerProvider, Regions.USEAST1);

iOS - Objective-C

若要使用開發人員驗證的身分，請實作您自己的身分供應商類別，此類別會延伸 AWSCognitoCredentialsProviderHelper。您的身分提供者類別應傳回包含權杖做為屬性的回應物件。

@implementation DeveloperAuthenticatedIdentityProvider
/*
 * Use the token method to communicate with your backend to get an
 * identityId and token.
 */

- (AWSTask <NSString*> *) token {
    //Write code to call your backend:
    //Pass username/password to backend or some sort of token to authenticate user
    //If successful, from backend call getOpenIdTokenForDeveloperIdentity with logins map 
    //containing "your.provider.name":"enduser.username"
    //Return the identity id and token to client
    //You can use AWSTaskCompletionSource to do this asynchronously

    // Set the identity id and return the token
    self.identityId = response.identityId;
    return [AWSTask taskWithResult:response.token];
}

@end

若要使用此身分提供者，請將其傳入 AWSCognitoCredentialsProvider，如下列範例所示。

DeveloperAuthenticatedIdentityProvider * devAuth = [[DeveloperAuthenticatedIdentityProvider alloc] initWithRegionType:AWSRegionYOUR_IDENTITY_POOL_REGION 
                                         identityPoolId:@"YOUR_IDENTITY_POOL_ID"
                                        useEnhancedFlow:YES
                                identityProviderManager:nil];
AWSCognitoCredentialsProvider *credentialsProvider = [[AWSCognitoCredentialsProvider alloc]
                                                          initWithRegionType:AWSRegionYOUR_IDENTITY_POOL_REGION
                                                          identityProvider:devAuth];

如果您想要同時支援未驗證的身分和開發人員驗證的身分，請覆寫 logins 實作中的 AWSCognitoCredentialsProviderHelper 方法。

- (AWSTask<NSDictionary<NSString *, NSString *> *> *)logins {
    if(/*logic to determine if user is unauthenticated*/) {
        return [AWSTask taskWithResult:nil];
    }else{
        return [super logins];
    }
}

如果您想要支援開發人員驗證的身分和社交供應商，您必須在 logins 的 AWSCognitoCredentialsProviderHelper 實作中，管理誰是目前的供應商。

- (AWSTask<NSDictionary<NSString *, NSString *> *> *)logins {
    if(/*logic to determine if user is unauthenticated*/) {
        return [AWSTask taskWithResult:nil];
    }else if (/*logic to determine if user is Facebook*/){
        return [AWSTask taskWithResult: @{ AWSIdentityProviderFacebook : [FBSDKAccessToken currentAccessToken] }];
    }else {
        return [super logins];
    }
}

iOS - Swift

若要使用開發人員驗證的身分，請實作您自己的身分供應商類別，此類別會延伸 AWSCognitoCredentialsProviderHelper。您的身分提供者類別應傳回包含權杖做為屬性的回應物件。

import AWSCore
/*
 * Use the token method to communicate with your backend to get an
 * identityId and token.
 */
class DeveloperAuthenticatedIdentityProvider : AWSCognitoCredentialsProviderHelper {
    override func token() -> AWSTask<NSString> {
    //Write code to call your backend:
    //pass username/password to backend or some sort of token to authenticate user, if successful, 
    //from backend call getOpenIdTokenForDeveloperIdentity with logins map containing "your.provider.name":"enduser.username"
    //return the identity id and token to client
    //You can use AWSTaskCompletionSource to do this asynchronously

    // Set the identity id and return the token
    self.identityId = resultFromAbove.identityId
    return AWSTask(result: resultFromAbove.token)
}

若要使用此身分提供者，請將其傳入 AWSCognitoCredentialsProvider，如下列範例所示。

let devAuth = DeveloperAuthenticatedIdentityProvider(regionType: .YOUR_IDENTITY_POOL_REGION, identityPoolId: "YOUR_IDENTITY_POOL_ID", useEnhancedFlow: true, identityProviderManager:nil)
let credentialsProvider = AWSCognitoCredentialsProvider(regionType: .YOUR_IDENTITY_POOL_REGION, identityProvider:devAuth)
let configuration = AWSServiceConfiguration(region: .YOUR_IDENTITY_POOL_REGION, credentialsProvider:credentialsProvider)
AWSServiceManager.default().defaultServiceConfiguration = configuration

如果您想要同時支援未驗證的身分和開發人員驗證的身分，請覆寫 logins 實作中的 AWSCognitoCredentialsProviderHelper 方法。

override func logins () -> AWSTask<NSDictionary> {
    if(/*logic to determine if user is unauthenticated*/) {
        return AWSTask(result:nil)
    }else {
        return super.logins()
    }
}

如果您想要支援開發人員驗證的身分和社交供應商，您必須在 logins 的 AWSCognitoCredentialsProviderHelper 實作中，管理誰是目前的供應商。

override func logins () -> AWSTask<NSDictionary> {
    if(/*logic to determine if user is unauthenticated*/) {
        return AWSTask(result:nil)
    }else if (/*logic to determine if user is Facebook*/){
        if let token = AccessToken.current?.authenticationToken {
            return AWSTask(result: [AWSIdentityProviderFacebook:token])
        }
        return AWSTask(error:NSError(domain: "Facebook Login", code: -1 , userInfo: ["Facebook" : "No current Facebook access token"]))
    }else {
        return super.logins()
    }
}

JavaScript

從後端取得身分 ID 和工作階段字符後，您必須將其傳遞至 AWS.CognitoIdentityCredentials 供應商中。範例如下。

AWS.config.credentials = new AWS.CognitoIdentityCredentials({
   IdentityPoolId: 'IDENTITY_POOL_ID',
   IdentityId: 'IDENTITY_ID_RETURNED_FROM_YOUR_PROVIDER',
   Logins: {
      'cognito-identity.amazonaws.com': 'TOKEN_RETURNED_FROM_YOUR_PROVIDER'
   }
});

Unity

若要使用開發人員驗證的身分，您必須擴展 CognitoAWSCredentials，並覆寫 RefreshIdentity 方法，以從後端擷取使用者身分 ID 和字符，並將其傳回。下列是身分供應商聯絡假設後端 'example.com' 的簡單範例：

using UnityEngine;
using System.Collections;
using Amazon.CognitoIdentity;
using System.Collections.Generic;
using ThirdParty.Json.LitJson;
using System;
using System.Threading;

public class DeveloperAuthenticatedCredentials : CognitoAWSCredentials
{
    const string PROVIDER_NAME = "example.com";
    const string IDENTITY_POOL = "IDENTITY_POOL_ID";
    static readonly RegionEndpoint REGION = RegionEndpoint.USEast1;

    private string login = null;

    public DeveloperAuthenticatedCredentials(string loginAlias)
        : base(IDENTITY_POOL, REGION)
    {
        login = loginAlias;
    }

    protected override IdentityState RefreshIdentity()
    {
        IdentityState state = null;
        ManualResetEvent waitLock = new ManualResetEvent(false);
        MainThreadDispatcher.ExecuteCoroutineOnMainThread(ContactProvider((s) =>
        {
            state = s;
            waitLock.Set();
        }));
        waitLock.WaitOne();
        return state;
    }

    IEnumerator ContactProvider(Action<IdentityState> callback)
    {
        WWW www = new WWW("http://example.com/?username="+login);
        yield return www;
        string response = www.text;

        JsonData json = JsonMapper.ToObject(response);

        //The backend has to send us back an Identity and a OpenID token
        string identityId = json["IdentityId"].ToString();
        string token = json["Token"].ToString();

        IdentityState state = new IdentityState(identityId, PROVIDER_NAME, token, false);
        callback(state);
    }
}

上述程式碼使用執行緒發送器物件來呼叫 coroutine。如果無法在您的專案中這麼做，您可以在您的場景中使用下列指令碼：

using System;
using UnityEngine;
using System.Collections;
using System.Collections.Generic;

public class MainThreadDispatcher : MonoBehaviour
{
    static Queue<IEnumerator> _coroutineQueue = new Queue<IEnumerator>();
    static object _lock = new object();

    public void Update()
    {
        while (_coroutineQueue.Count > 0)
        {
            StartCoroutine(_coroutineQueue.Dequeue());
        }
    }

    public static void ExecuteCoroutineOnMainThread(IEnumerator coroutine)
    {
        lock (_lock) {
            _coroutineQueue.Enqueue(coroutine);
        }
    }
}

Xamarin

若要使用開發人員驗證的身分，您必須擴展 CognitoAWSCredentials，並覆寫 RefreshIdentity 方法，以從後端擷取使用者身分 ID 和字符，並將其傳回。下列是身分供應商聯絡假設後端 'example.com' 的基礎範例：

public class DeveloperAuthenticatedCredentials : CognitoAWSCredentials
{
    const string PROVIDER_NAME = "example.com";
    const string IDENTITY_POOL = "IDENTITY_POOL_ID";
    static readonly RegionEndpoint REGION = RegionEndpoint.USEast1;
    private string login = null;

    public DeveloperAuthenticatedCredentials(string loginAlias)
        : base(IDENTITY_POOL, REGION)
    {
        login = loginAlias;
    }

    protected override async Task<IdentityState> RefreshIdentityAsync()
    {
        IdentityState state = null;
        //get your identity and set the state
        return state;
    }
}

Android

在向您的身分驗證系統成功驗證使用者之後，請更新登入對應中的開發人員供應商名稱和開發使用者識別符。開發使用者識別符是英數字串，可唯一識別的身分驗證系統中的使用者。更新登入後，請務必呼叫 refresh方法，因為 identityId 對應可能有所變更：

HashMap<String, String> loginsMap = new HashMap<String, String>();
loginsMap.put(developerAuthenticationProvider.getProviderName(), developerUserIdentifier);

credentialsProvider.setLogins(loginsMap);
credentialsProvider.refresh();

iOS - Objective-C

除非沒有登入資料，或登入資料已過期，iOS 軟體開發套件才會呼叫 logins方法來取得最新的登入對應。如果您想要強制該軟體開發套件取得新的登入資料 (例如，最終使用者從未驗證變成已驗證，而您想要已驗證使用者的登入資料)，請在 clearCredentials 上呼叫 credentialsProvider。

[credentialsProvider clearCredentials];

iOS - Swift

除非沒有登入資料，或登入資料已過期，iOS 軟體開發套件才會呼叫 logins方法來取得最新的登入對應。如果您想要強制該軟體開發套件取得新的登入資料 (例如，最終使用者從未驗證變成已驗證，而您想要已驗證使用者的登入資料)，請在 clearCredentials上呼叫 credentialsProvider。

credentialsProvider.clearCredentials()

Android

您的應用程式可能需要支援未驗證的身分或使用公有身分供應商 (Login with Amazon、Sign in with Apple、Facebook 或 Google) 驗證的身分，以及開發人員驗證的身分。開發人員驗證的身分與其他身分 (未驗證的身分和使用公有供應商驗證的身分) 之間的基本差異，在於取得 identityId 和字符的方式。針對其他身分，行動應用程式會直接與 Amazon Cognito 互動，而不會聯絡您的身分驗證系統。所以行動應用程式應該能夠依據應用程式使用者的選擇，支援兩種不同的流程。因此，您必須對自訂身分供應商進行一些變更。

refresh 方法檢查登錄映射。如果映射不是空的，且擁有開發人員供應商名稱的金鑰，則會呼叫後端。否則，會呼叫 getIdentityId 方法並傳回無效值。

public String refresh() {

   setToken(null);

   // If the logins map is not empty make a call to your backend
   // to get the token and identityId
   if (getProviderName() != null &&
      !this.loginsMap.isEmpty() &&
      this.loginsMap.containsKey(getProviderName())) {

      /**
       * This is where you would call your backend
       **/

      // now set the returned identity id and token in the provider
      update(identityId, token);
      return token;

   } else {
      // Call getIdentityId method and return null
      this.getIdentityId();
      return null;
   }
}

同樣地，依據登入對應的內容，getIdentityId方法也會有兩個流程：

public String getIdentityId() {

   // Load the identityId from the cache
   identityId = cachedIdentityId;

   if (identityId == null) {

      // If the logins map is not empty make a call to your backend
      // to get the token and identityId

      if (getProviderName() != null && !this.loginsMap.isEmpty()
         && this.loginsMap.containsKey(getProviderName())) {

         /**
           * This is where you would call your backend
          **/

         // now set the returned identity id and token in the provider
         update(identityId, token);
         return token;

      } else {
         // Otherwise call &COG; using getIdentityId of super class
         return super.getIdentityId();
      }

   } else {
      return identityId;
   }

}

iOS - Objective-C

您的應用程式可能需要支援未驗證的身分或使用公有身分供應商 (Login with Amazon、Sign in with Apple、Facebook 或 Google) 驗證的身分，以及開發人員驗證的身分。若要這麼做，請覆寫 AWSCognitoCredentialsProviderHelper logins 方法，使其能夠依據目前的身分供應商，傳回正確的登入對應。此範例說明如何在未驗證、Facebook 和開發人員驗證的身分之間轉換。

- (AWSTask<NSDictionary<NSString *, NSString *> *> *)logins {
    if(/*logic to determine if user is unauthenticated*/) {
        return [AWSTask taskWithResult:nil];
    }else if (/*logic to determine if user is Facebook*/){
        return [AWSTask taskWithResult: @{ AWSIdentityProviderFacebook : [FBSDKAccessToken currentAccessToken] }];
    }else {
        return [super logins];
    }
}

當您從未驗證轉換至已驗證時，應呼叫 [credentialsProvider clearCredentials];，以強制軟體開發套件取得新的已驗證登入資料。如果您在兩個已驗證的供應商之間切換，而不嘗試將這兩個供應商連結 (例如，您不要在登入字典中提供多個供應商的權杖)，則應呼叫 [credentialsProvider clearKeychain];。這樣會同時清除登入資料和身分，並強制軟體開發套件取得新的登入資料和身分。

iOS - Swift

您的應用程式可能需要支援未驗證的身分或使用公有身分供應商 (Login with Amazon、Sign in with Apple、Facebook 或 Google) 驗證的身分，以及開發人員驗證的身分。若要這麼做，請覆寫 AWSCognitoCredentialsProviderHelper logins 方法，使其能夠依據目前的身分供應商，傳回正確的登入對應。此範例說明如何在未驗證、Facebook 和開發人員驗證的身分之間轉換。

override func logins () -> AWSTask<NSDictionary> {
    if(/*logic to determine if user is unauthenticated*/) {
        return AWSTask(result:nil)
    }else if (/*logic to determine if user is Facebook*/){
        if let token = AccessToken.current?.authenticationToken {
            return AWSTask(result: [AWSIdentityProviderFacebook:token])
        }
        return AWSTask(error:NSError(domain: "Facebook Login", code: -1 , userInfo: ["Facebook" : "No current Facebook access token"]))
    }else {
        return super.logins()
    }
}

當您從未驗證轉換至已驗證時，應呼叫 credentialsProvider.clearCredentials()，以強制軟體開發套件取得新的已驗證登入資料。如果您在兩個已驗證的供應商之間切換，而不嘗試將這兩個供應商連結 (也就是說，您不要在登入字典中提供多個供應商的權杖)，則應呼叫 credentialsProvider.clearKeychain()。這樣會同時清除登入資料和身分，並強制軟體開發套件取得新的登入資料和身分。

Unity

您的應用程式可能需要支援未驗證的身分或使用公有身分供應商 (Login with Amazon、Sign in with Apple、Facebook 或 Google) 驗證的身分，以及開發人員驗證的身分。開發人員驗證的身分與其他身分 (未驗證的身分和使用公有供應商驗證的身分) 之間的基本差異，在於取得 identityId 和字符的方式。針對其他身分，行動應用程式會直接與 Amazon Cognito 互動，而不會聯絡您的身分驗證系統。行動應用程式應該能夠依據應用程式使用者的選擇，支援兩種不同的流程。因此，您必須對自訂身分供應商進行一些變更。

在 Unity 中，建議的作法是從 AmazonCognitoEnhancedIdentityProvide (而不是從 AbstractCognitoIdentityProvider) 擴展您的身分提供者，並呼叫父系 RefreshAsync 方法 (而不是自己的方法)，以免使用者未向您自己的後端驗證身分。如果使用者已驗證，則您可以使用先前說明的相同流程。

Xamarin

您的應用程式可能需要支援未驗證的身分或使用公有身分供應商 (Login with Amazon、Sign in with Apple、Facebook 或 Google) 驗證的身分，以及開發人員驗證的身分。開發人員驗證的身分與其他身分 (未驗證的身分和使用公有供應商驗證的身分) 之間的基本差異，在於取得 identityId 和字符的方式。針對其他身分，行動應用程式會直接與 Amazon Cognito 互動，而不會聯絡您的身分驗證系統。行動應用程式應該能夠依據應用程式使用者的選擇，支援兩種不同的流程。因此，您必須對自訂身分供應商進行一些變更。