Эта страница переведена с помощью Cloud Translation API.

Приложение Флип для Android

Если у вас есть реализация OAuth 2.0, вы можете дополнительно настроить App Flip , which allows your Android users to more quickly link their accounts in your authentication system to their Google accounts. The following sections describe how to design and implement App Flip for your smart home Action.

Настройте сервер OAuth 2.0. Дополнительные сведения о настройке сервера OAuth см. в разделе Реализация сервера OAuth 2.0 .
Создать действие. Чтобы создать действие, следуйте инструкциям в разделе Создание проекта действий .

Настройте App Flip в консоли действий.

В следующем разделе описывается, как настроить App Flip в консоли действий .

Заполните все поля под информацией о клиенте OAuth. (Если App Flip не поддерживается, в качестве запасного варианта используется обычный OAuth.)
В разделе Использовать приложение для привязки аккаунта (необязательно) установите флажок Включить для Android.
Заполните следующие поля:

Идентификатор приложения. Идентификатор приложения — это уникальный идентификатор, который вы устанавливаете для своего приложения.
Подпись приложения. Приложения для Android должны быть «подписаны» сертификатом открытого ключа, прежде чем их можно будет установить. Сведения о получении подписи вашего приложения см. в разделе Аутентификация вашего клиента .
Цель авторизации. В этом поле введите строку, определяющую ваше намерение.

Если вы хотите дополнительно настроить клиент, добавьте области и щелкните Добавить область в разделе Настроить клиент (необязательно).
Щелкните Сохранить.

Реализуйте App Flip в своих приложениях для Android

Чтобы внедрить App Flip, вам нужно изменить код авторизации пользователя в вашем приложении, чтобы он принимал ссылку на контент от Google.

Связывание App Flip на основе OAuth (App Flip) вставляет ваше Android-приложение в процесс связывания аккаунта Google. Традиционный процесс привязки учетной записи требует, чтобы пользователь ввел свои учетные данные в браузере. Использование App Flip откладывает вход пользователя в ваше приложение для Android, что позволяет вам использовать существующие авторизации. Если пользователь вошел в ваше приложение, ему не нужно повторно вводить свои учетные данные, чтобы связать свою учетную запись. Для реализации App Flip в вашем приложении для Android требуется минимальное количество изменений кода.

В этом документе вы узнаете, как изменить приложение Android для поддержки App Flip.

Попробуйте образец

Пример приложения для связывания App Flip демонстрирует совместимую с App Flip интеграцию связывания учетных записей на Android. Вы можете использовать это приложение, чтобы проверить, как реагировать на входящие намерения App Flip из мобильных приложений Google.

Образец приложения предварительно настроен для интеграции с инструментом тестирования App Flip для Android , который можно использовать для проверки интеграции вашего приложения Android с App Flip перед настройкой привязки учетной записи к Google. Это приложение имитирует намерение, инициируемое мобильными приложениями Google, когда включен App Flip.

Как это работает

Для интеграции App Flip необходимы следующие шаги:

Приложение Google проверяет, установлено ли ваше приложение на устройстве, используя имя пакета .
Приложение Google использует проверку подписи пакета, чтобы убедиться, что установленное приложение является правильным приложением.
Приложение Google формирует намерение начать определенное действие в вашем приложении. Это намерение включает дополнительные данные, необходимые для связывания. Он также проверяет, поддерживает ли ваше приложение App Flip, разрешая это намерение через инфраструктуру Android.
Ваше приложение подтверждает, что запрос исходит от приложения Google. Для этого ваше приложение проверяет подпись пакета и предоставленный идентификатор клиента.
Ваше приложение запрашивает код авторизации с вашего сервера OAuth 2.0. В конце этого потока он возвращает либо код авторизации, либо ошибку в приложение Google.
Приложение Google получает результат и продолжает привязку аккаунта. Если предоставлен код авторизации, обмен токенами происходит между серверами так же, как и в процессе связывания OAuth на основе браузера.

Измените свое приложение для Android, чтобы оно поддерживало App Flip

Для поддержки App Flip внесите следующие изменения в код своего приложения для Android:

Добавьте <intent-filter> в файл AndroidManifest.xml со строкой действия, которая соответствует значению, введенному вами в поле App Flip Intent .

<activity android:name="AuthActivity">
  <!-- Handle the app flip intent -->
  <intent-filter>
    <action android:name="INTENT_ACTION_FROM_CONSOLE"/>
    <category android:name="android.intent.category.DEFAULT"/>
  </intent-filter>
</activity>

Проверьте подпись вызывающего приложения.

private fun verifyFingerprint(
        expectedPackage: String,
        expectedFingerprint: String,
        algorithm: String
): Boolean {

    callingActivity?.packageName?.let {
        if (expectedPackage == it) {
            val packageInfo =
                packageManager.getPackageInfo(it, PackageManager.GET_SIGNATURES)
            val signatures = packageInfo.signatures
            val input = ByteArrayInputStream(signatures[0].toByteArray())

            val certificateFactory = CertificateFactory.getInstance("X509")
            val certificate =
                certificateFactory.generateCertificate(input) as X509Certificate
            val md = MessageDigest.getInstance(algorithm)
            val publicKey = md.digest(certificate.encoded)
            val fingerprint = publicKey.joinToString(":") { "%02X".format(it) }

            return (expectedFingerprint == fingerprint)
        }
    }
    return false
}

Извлеките идентификатор клиента из параметров намерения и убедитесь, что идентификатор клиента соответствует ожидаемому значению.

private const val EXPECTED_CLIENT = "<client-id-from-actions-console>"
private const val EXPECTED_PACKAGE = "<google-app-package-name>"
private const val EXPECTED_FINGERPRINT = "<google-app-signature>"
private const val ALGORITHM = "SHA-256"
...

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    val clientId = intent.getStringExtra("CLIENT_ID")

    if (clientId == EXPECTED_CLIENT &&
        verifyFingerprint(EXPECTED_PACKAGE, EXPECTED_FINGERPRINT, ALGORITHM)) {

        // ...authorize the user...
    }
}

После успешной авторизации верните полученный код авторизации обратно в Google.

// Successful result
val data = Intent().apply {
    putExtra("AUTHORIZATION_CODE", authCode)
}
setResult(Activity.RESULT_OK, data)
finish()

Если произошла ошибка, вместо этого верните результат ошибки.
Примечание. Не обрабатывайте ошибку непосредственно в приложении, вместо этого возвращайте результат ошибки через setResult . Это гарантирует, что соответствующий резервный метод активируется в случае сбоя потока связывания приложения.
```
// Error result
val error = Intent().apply {
    putExtra("ERROR_TYPE", 1)
    putExtra("ERROR_CODE", 1)
    putExtra("ERROR_DESCRIPTION", "Invalid Request")
}
setResult(-2, error)
finish()
```

Содержание намерения запуска

Намерение Android, которое запускает ваше приложение, включает следующие поля:

CLIENT_ID ( String ): client_id Google, зарегистрированный в вашем приложении.
SCOPE ( String[] ): список запрошенных областей.
REDIRECT_URI ( String ): URL-адрес перенаправления.

Содержание данных ответа

Данные, возвращаемые в приложение Google, устанавливаются в вашем приложении с помощью вызова setResult() . Эти данные включают следующее:

AUTHORIZATION_CODE ( String ): значение кода авторизации.
resultCode ( int ): сообщает об успехе или неудаче процесса и принимает одно из следующих значений:
- Activity.RESULT_OK : указывает на успех; возвращается код авторизации.
- Activity.RESULT_CANCELLED : сигнализирует о том, что пользователь отменил процесс. В этом случае приложение Google попытается связать учетную запись, используя ваш URL-адрес авторизации.
- -2 : Указывает, что произошла ошибка. Ниже описаны различные типы ошибок.
ERROR_TYPE ( int ): тип ошибки, который принимает одно из следующих значений:
- 1 : Устранимая ошибка: приложение Google попытается связать учетную запись, используя URL-адрес авторизации.
- 2 : Неисправимая ошибка: приложение Google прерывает привязку аккаунта.
- 3 : Недопустимые или отсутствующие параметры запроса.
ERROR_CODE ( int ): целое число, представляющее характер ошибки. Чтобы узнать, что означает каждый код ошибки, обратитесь к таблице кодов ошибок .
ERROR_DESCRIPTION ( String , необязательно): понятное человеку сообщение о состоянии с описанием ошибки.
Примечание. Дополнительные сведения о возможных ошибках и необязательном содержимом поля error_description см. в стандарте OAuth 2.0.

Значение для AUTHORIZATION_CODE ожидается, когда resultCode == Activity.RESULT_OK . Во всех остальных случаях значение AUTHORIZATION_CODE должно быть пустым. Если resultCode == -2 , ожидается, что значение ERROR_TYPE будет заполнено.

Таблица кодов ошибок

В таблице ниже показаны различные коды ошибок, а также то, является ли каждый из них устранимой или неустранимой ошибкой:

Код ошибки	Значение	Восстанавливаемый	Неисправимый
`1`	`INVALID_REQUEST`	✔
`2`	`NO_INTERNET_CONNECTION`		✔
`3`	`OFFLINE_MODE_ACTIVE`	✔
`4`	`CONNECTION_TIMEOUT`	✔
`5`	`INTERNAL_ERROR`	✔
`6`	`AUTHENTICATION_SERVICE_UNAVAILABLE`		✔
`8`	`CLIENT_VERIFICATION_FAILED`	✔
`9`	`INVALID_CLIENT`	✔
`10`	`INVALID_APP_ID`	✔
`11`	`INVALID_REQUEST`	✔
`12`	`AUTHENTICATION_SERVICE_UNKNOWN_ERROR`		✔
`13`	`AUTHENTICATION_DENIED_BY_USER`		✔
`14`	`CANCELLED_BY_USER`		✔
`15`	`FAILURE_OTHER`		✔
`16`	`USER_AUTHENTICATION_FAILED`	✔

Для всех кодов ошибок вы должны вернуть результат ошибки через setResult , чтобы обеспечить запуск соответствующего отката.

Протестируйте приложение Flip на своем устройстве

Теперь, когда вы создали действие и настроили App Flip на консоли и в своем приложении, вы можете протестировать App Flip на своем мобильном устройстве. Вы можете использовать приложение Google Assistant или приложение Google Home, чтобы протестировать App Flip.

Чтобы протестировать App Flip из приложения Assistant, выполните следующие действия:

Перейдите в консоль Actions и выберите свой проект.
Нажмите «Тест» в верхней части навигации.
Запустите процесс привязки учетной записи из приложения Assistant:

Откройте приложение Google Ассистент .
Щелкните Настройки .
На вкладке «Помощник» нажмите «Управление домом».
Нажмите Добавить(+) .
Выберите действие из списка поставщиков. Он будет иметь префикс «[test]» в списке. Когда вы выбираете действие [test] из списка, оно должно открыть ваше приложение.
Убедитесь, что ваше приложение запущено, и начните тестирование процесса авторизации.

Чтобы протестировать App Flip из приложения Home, выполните следующие действия:

Перейдите в консоль Actions и выберите свой проект.
Нажмите «Тест» в верхней части навигации.
Запустите процесс привязки учетной записи из приложения Home:

Откройте приложение Google Home .
Нажмите кнопку + .
Щелкните Настроить устройство .
Нажмите Что-то уже настроено?
Выберите действие вашего умного дома из списка провайдеров. Он будет иметь префикс «[test]» в списке. Когда вы выбираете действие [test] из списка, оно должно открыть ваше приложение.
Убедитесь, что ваше приложение запущено, и начните тестирование процесса авторизации.

Создать проект действий

Определить и синхронизировать