本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 將未驗證的使用者切換至已驗證的使用者
<a name="switching-identities"></a>

Amazon Cognito 身分集區可支援已驗證和未驗證的使用者。未經驗證的使用者即使未透過任何身分提供者 (IdPs) 登入，也可以存取您的 AWS 資源。這個程度的存取能在使用者登入前就顯示內容，非常有用。每個未驗證使用者在身分集區中都有專屬身分 (即使使用者尚未個別登入和驗證身分亦同)。

本節說明您的使用者選擇從未驗證身分登入，轉為使用經驗證身分登入的程序。

## Android
<a name="switching-identities-1.android"></a>

使用者可使用未驗證的訪客身分來登入您的應用程式，最後他們可能會決定使用其中一個支援的 IdP 來登入。Amazon Cognito 確保舊身分保留與新身分相同的唯一識別符，且設定檔資料會自動合併。

設定檔合併的訊息會透過 `IdentityChangedListener` 界面來通知您的應用程式。請在該界面中實作 `identityChanged` 方法，以接收這些訊息：

```
@override
public void identityChanged(String oldIdentityId, String newIdentityId) {
    // handle the change
}
```

## iOS - Objective-C
<a name="switching-identities-1.ios-objc"></a>

使用者可使用未驗證的訪客身分來登入您的應用程式，最後他們可能會決定使用其中一個支援的 IdP 來登入。Amazon Cognito 確保舊身分保留與新身分相同的唯一識別符，且設定檔資料會自動合併。

`NSNotificationCenter` 會通知您的應用程式設定檔合併的訊息：

```
[[NSNotificationCenter defaultCenter] addObserver:self
                                      selector:@selector(identityIdDidChange:)
                                      name:AWSCognitoIdentityIdChangedNotification
                                      object:nil];

-(void)identityDidChange:(NSNotification*)notification {
    NSDictionary *userInfo = notification.userInfo;
    NSLog(@"identity changed from %@ to %@",
        [userInfo objectForKey:AWSCognitoNotificationPreviousId],
        [userInfo objectForKey:AWSCognitoNotificationNewId]);
}
```

## iOS - Swift
<a name="switching-identities-1.ios-swift"></a>

使用者可使用未驗證的訪客身分來登入您的應用程式，最後他們可能會決定使用其中一個支援的 IdP 來登入。Amazon Cognito 確保舊身分保留與新身分相同的唯一識別符，且設定檔資料會自動合併。

`NSNotificationCenter` 會通知您的應用程式設定檔合併的訊息：

```
[NSNotificationCenter.defaultCenter().addObserver(observer: self
   selector:"identityDidChange"
   name:AWSCognitoIdentityIdChangedNotification
   object:nil)

func identityDidChange(notification: NSNotification!) {
  if let userInfo = notification.userInfo as? [String: AnyObject] {
    print("identity changed from: \(userInfo[AWSCognitoNotificationPreviousId])
    to: \(userInfo[AWSCognitoNotificationNewId])")
  }
}
```

## JavaScript
<a name="switching-identities-1.javascript"></a>

### 最初未進行身分驗證的使用者
<a name="switching-identities-1.javascript-unauth"></a>

使用者通常在一開始會使用未驗證角色。針對此角色，您設定的組態物件之登入資料屬性不需登入屬性。在這種情況下，您的預設組態可能如下所示：

```
// set the default config object
var creds = new AWS.CognitoIdentityCredentials({
    IdentityPoolId: 'us-east-1:1699ebc0-7900-4099-b910-2df94f52a030'
});
AWS.config.credentials = creds;
```

### 切換到已進行身分驗證使用者
<a name="switching-identities-1.javascript-auth"></a>

當未驗證使用者登入 IdP，且您有一個權杖時，您可以透過呼叫自訂函數更新登入資料物件並新增登入權杖，將使用者從未驗證切換為已驗證：

```
// Called when an identity provider has a token for a logged in user
function userLoggedIn(providerName, token) {
    creds.params.Logins = creds.params.Logins || {};
    creds.params.Logins[providerName] = token;

    // Expire credentials to refresh them on the next request
    creds.expired = true;
}
```

您也可建立 `CognitoIdentityCredentials` 物件。如果您建立此物件，您必須重設任何現有的服務物件登入資料屬性，以反映經更新的登入資料組態資訊。請參閱[使用全域組態物件](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/global-config-object.html)。

如需`CognitoIdentityCredentials`物件的詳細資訊，請參閱 適用於 JavaScript 的 AWS SDK API 參考中的 [AWS.CognitoIdentityCredentials](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/CognitoIdentityCredentials.html)。

## Unity
<a name="switching-identities-1.unity"></a>

使用者可使用未驗證的訪客身分來登入您的應用程式，最後他們可能會決定使用其中一個支援的 IdP 來登入。Amazon Cognito 確保舊身分保留與新身分相同的唯一識別符，且設定檔資料會自動合併。

您可以訂閱 `IdentityChangedEvent`，以接收設定檔合併的訊息：

```
credentialsProvider.IdentityChangedEvent += delegate(object sender, CognitoAWSCredentials.IdentityChangedArgs e)
{
    // handle the change
    Debug.log("Identity changed from " + e.OldIdentityId + " to " + e.NewIdentityId);
};
```

## Xamarin
<a name="switching-identities-1.xamarin"></a>

使用者可使用未驗證的訪客身分來登入您的應用程式，最後他們可能會決定使用其中一個支援的 IdP 來登入。Amazon Cognito 確保舊身分保留與新身分相同的唯一識別符，且設定檔資料會自動合併。

```
credentialsProvider.IdentityChangedEvent += delegate(object sender, CognitoAWSCredentials.IdentityChangedArgs e){
    // handle the change
    Console.WriteLine("Identity changed from " + e.OldIdentityId + " to " + e.NewIdentityId);
};
```