AbstractAccountAuthenticator.GetAuthToken Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene un authtoken per un account.
[Android.Runtime.Register("getAuthToken", "(Landroid/accounts/AccountAuthenticatorResponse;Landroid/accounts/Account;Ljava/lang/String;Landroid/os/Bundle;)Landroid/os/Bundle;", "GetGetAuthToken_Landroid_accounts_AccountAuthenticatorResponse_Landroid_accounts_Account_Ljava_lang_String_Landroid_os_Bundle_Handler")]
public abstract Android.OS.Bundle? GetAuthToken (Android.Accounts.AccountAuthenticatorResponse? response, Android.Accounts.Account? account, string? authTokenType, Android.OS.Bundle? options);
[<Android.Runtime.Register("getAuthToken", "(Landroid/accounts/AccountAuthenticatorResponse;Landroid/accounts/Account;Ljava/lang/String;Landroid/os/Bundle;)Landroid/os/Bundle;", "GetGetAuthToken_Landroid_accounts_AccountAuthenticatorResponse_Landroid_accounts_Account_Ljava_lang_String_Landroid_os_Bundle_Handler")>]
abstract member GetAuthToken : Android.Accounts.AccountAuthenticatorResponse * Android.Accounts.Account * string * Android.OS.Bundle -> Android.OS.Bundle
Parametri
- response
- AccountAuthenticatorResponse
per restituire il risultato a AccountManager, non sarà mai null
- account
- Account
l'account le cui credenziali devono essere recuperate, non sarà mai null
- authTokenType
- String
il tipo di token di autenticazione da recuperare, non sarà mai null
- options
- Bundle
un bundle di opzioni specifiche dell'autenticatore. Contiene AccountManager#KEY_CALLER_PID
sempre campi e AccountManager#KEY_CALLER_UID
che consentirà all'autenticatore di conoscere l'identità del chiamante.
Restituisce
risultato del bundle o null se il risultato deve essere restituito tramite la risposta.
- Attributi
Eccezioni
se l'autenticatore non è riuscito ad rispettare la richiesta a causa di un errore di rete
Commenti
Ottiene un authtoken per un account.
In caso contrario null
, il risultante Bundle
conterrà set di chiavi diversi a seconda che un token sia stato emesso correttamente e, in caso contrario, se è possibile emesso tramite alcuni android.app.Activity
.
Se non è possibile fornire un token senza attività aggiuntive, il bundle deve contenere AccountManager#KEY_INTENT
con un oggetto associato Intent
. D'altra parte, se non esiste alcuna attività di questo tipo, deve essere restituito un bundle contenente AccountManager#KEY_ERROR_CODE
e AccountManager#KEY_ERROR_MESSAGE
.
Se un token può essere rilasciato correttamente, l'implementazione deve restituire e AccountManager#KEY_ACCOUNT_NAME
AccountManager#KEY_ACCOUNT_TYPE
dell'account associato al token, nonché .AccountManager#KEY_AUTHTOKEN
Inoltre AbstractAccountAuthenticator
, le implementazioni che dichiarano se stesse android:customTokens=true
possono anche fornire un valore long non negativo #KEY_CUSTOM_TOKEN_EXPIRY
contenente il timestamp di scadenza dell'ora di scadenza (in millis dall'epoca unix), i token verranno memorizzati nella cache in memoria in base al valore packageName/signature dell'applicazione per quanto tempo specificato.
Gli implementatori devono presupporre che i token vengano memorizzati nella cache in base all'account e a authTokenType. Il sistema può ignorare il contenuto delle opzioni fornite Bundle durante la determinazione del riutilizzo di un token memorizzato nella cache. Inoltre, i responsabili dell'implementazione devono presupporre che una scadenza fornita verrà considerata come un consiglio non vincolante.
Infine, si noti che per android:customTokens=false
gli autenticatori, i token vengono memorizzati nella cache per un periodo illimitato fino a quando alcuni client chiamano AccountManager#invalidateAuthToken(String,String)
.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.