AbstractAccountAuthenticator.GetAuthToken Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает проверку подлинности для учетной записи.
[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
Параметры
- response
- AccountAuthenticatorResponse
чтобы отправить результат обратно в AccountManager, никогда не будет иметь значение NULL
- account
- Account
учетная запись, учетные данные которой необходимо извлечь, никогда не будет иметь значение NULL.
- authTokenType
- String
Тип маркера проверки подлинности, который требуется получить, никогда не будет иметь значение NULL
- options
- Bundle
Пакет параметров для проверки подлинности. Он всегда содержит AccountManager#KEY_CALLER_PID
и AccountManager#KEY_CALLER_UID
поля, которые позволяют аутентификатору знать удостоверение вызывающего объекта.
Возвращаемое значение
Результат пакета или значение NULL, если результат должен быть возвращен через ответ.
- Атрибуты
Исключения
Если средство проверки подлинности не удалось выполнить запрос из-за ошибки сети
Комментарии
Возвращает проверку подлинности для учетной записи.
Если нет null
, результат будет Bundle
содержать разные наборы ключей в зависимости от того, был ли токен успешно выдан и, если нет, можно ли выдается через некоторые android.app.Activity
.
Если маркер не может быть предоставлен без какого-то дополнительного действия, пакет должен содержать AccountManager#KEY_INTENT
связанный Intent
. С другой стороны, если такого действия нет, то пакет, содержащий AccountManager#KEY_ERROR_CODE
и AccountManager#KEY_ERROR_MESSAGE
должен быть возвращен.
Если маркер может быть успешно выдан, реализация должна возвращать AccountManager#KEY_ACCOUNT_NAME
и AccountManager#KEY_ACCOUNT_TYPE
учетную запись, связанную с маркером, а также AccountManager#KEY_AUTHTOKEN
. Кроме того AbstractAccountAuthenticator
, реализации, объявляющие себя android:customTokens=true
, также могут предоставлять неотрицательное #KEY_CUSTOM_TOKEN_EXPIRY
длинное значение, содержащее метку времени окончания срока действия (в милли с эпохи unix), маркеры будут кэшироваться в памяти на основе имени пакета или подписи приложения в течение определенного времени.
Разработчики должны предположить, что маркеры будут кэшироваться на основе учетной записи и authTokenType. Система может игнорировать содержимое предоставленного пакета параметров при определении повторного использования кэшированного токена. Кроме того, разработчики должны предположить, что предоставленное время истечения срока действия будет рассматриваться как советы, не относящиеся к привязке.
Наконец, обратите внимание, что для android:customTokens=false
аутентификаторов маркеры кэшируются на неопределенный срок до некоторых вызовов AccountManager#invalidateAuthToken(String,String)
клиента.
Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.