Настройте беспрепятственный обмен учетными данными между приложениями и веб-сайтами Android.

Максимизируйте удобство пользователя, обеспечив беспрепятственный межплатформенный обмен учетными данными между вашими приложениями и веб-сайтами. Когда несколько веб-сайтов и приложений Android используют один и тот же сервер управления учетными записями, эта функция позволяет пользователям один раз сохранить учетные данные и автоматически предлагать их на любом связанном веб-сайте или в приложении Android.

Существует два поддерживаемых метода настройки совместного использования учетных данных:

• Play Console : рекомендуется большинству разработчиков при настройке совместного использования учетных данных с приложениями Android. Этот метод позволяет настроить совместное использование учетных данных без необходимости выпуска новой версии приложения. Обратите внимание: даже при использовании Play Console вам все равно необходимо опубликовать действительный файл assetlinks.json на своем веб-сайте.
• Ссылки на цифровые активы (DAL) : подходят для расширенных вариантов использования, таких как поддержка нескольких приложений или доменов с более сложными конфигурациями.

Ключевой момент: независимо от того, как вы настроили совместное использование учетных данных, Менеджер паролей рассматривает отношения совместного использования учетных данных как транзитивные. Это означает, что если веб-сайт A использует общие учетные данные с веб-сайтом C, а веб-сайт B также разделяет учетные данные с веб-сайтом C, то веб-сайты A и веб-сайты B также будут автоматически обмениваться учетными данными друг с другом.

Лучшие практики

Для оптимального взаимодействия с пользователем и обеспечения безопасности внедрите беспрепятственный обмен учетными данными в следующих точках взаимодействия:

• Форма входа : включите автоматическое заполнение учетных данных.
• Форма регистрации : надежно храните новые учетные данные для использования на разных платформах.
• Форма смены пароля : синхронизируйте обновления паролей на всех платформах.
• Форма сброса пароля . Разрешить сброс одного пароля для обновления всех платформ.
• Домены веб-просмотра . Расширьте общий доступ к учетным данным на домены веб-просмотра в вашем приложении, которые обрабатывают управление учетными записями (вход в систему, регистрация, смена пароля или формы сброса пароля).
• Приложения для Android

Такой подход создает единую систему управления учетными данными, повышая удобство и безопасность пользователей.

При разработке веб-сайтов управления учетными записями мы предлагаем вам следовать следующим рекомендациям для сайтов управления учетными записями:

• Создайте форму регистрации в соответствии с лучшими практиками
• Создайте форму входа в соответствии с лучшими практиками.
• Добавьте известный URL для смены паролей

При разработке приложений для Android мы рекомендуем интегрировать их с Android Credential Manager .

Настройте общий доступ к учетным данным с помощью Play Console.

Теперь вы можете включить беспрепятственный обмен учетными данными прямо из Play Console , не публикуя новую версию приложения для Android. Этот метод упрощает процесс, управляя конфигурациями совместного использования учетных данных через интерфейс Play Console.

Совет: Play Console генерирует необходимый фрагмент JSON, указывает, где его опубликовать на вашем веб-сайте, а затем проверяет его, как только он будет готов, чтобы предотвратить ошибки конфигурации.

Предварительные условия

Прежде чем настраивать общий доступ к учетным данным с помощью Play Console, убедитесь, что у вас есть:

• Необходимые разрешения Play Console для доступа к разделам «Глубокие ссылки» и «Конфигурация приложения» . Если вы не являетесь владельцем учетной записи, попросите администратора Play Console предоставить вам соответствующий доступ.
• Возможность публикации файла /.well-known/assetlinks.json в каждом соответствующем домене в соответствии с синтаксисом ссылок на цифровые активы (DAL) .

Включить общий доступ к учетным данным для нового домена

Чтобы настроить беспрепятственный обмен учетными данными в Play Console для нового домена, выполните следующие действия:

1. Откройте Play Console и перейдите на страницу глубоких ссылок ( Расширение пользователей > Глубокие ссылки ).
2. На вкладке «Конфигурация приложения» нажмите «Добавить домен» .
3. Введите домен вашего сайта.
4. Включите переключатель Включить общий доступ к учетным данным .
5. Скопируйте созданный файл JSON и опубликуйте его в указанном месте ( https://YOUR_DOMAIN/.well-known/assetlinks.json согласно протоколу ) или добавьте соответствующую информацию в существующий файл assetslinks.json.
6. Нажмите Создать ассоциацию веб-сайта .

В случае успеха вы вернетесь на страницу глубоких ссылок .

Включить совместное использование учетных данных для существующего домена

Чтобы настроить беспрепятственный обмен учетными данными в Play Console для существующего домена, выполните следующие действия:

1. Выберите вкладку «Конфигурация приложения» .
2. В разделе «Домены» в разделе «Конфигурация приложения» нажмите « Включить» в столбце «Общий доступ к учетным данным» .
3. Скопируйте созданный файл JSON и опубликуйте его в указанном месте (или добавьте соответствующую информацию в существующий файл assetlinks.json ).
4. Нажмите Включить совместное использование учетных данных .

В случае успеха вы вернетесь на страницу глубоких ссылок .

Настройте совместное использование учетных данных, используя только ссылки на цифровые активы (DAL).

Для сложных настроек, включающих несколько приложений или веб-сайтов, используйте ссылки на цифровые активы (DAL), чтобы настроить совместное использование учетных данных вручную.

Предварительные условия

Прежде чем настраивать беспрепятственный обмен учетными данными, убедитесь, что у вас есть следующее для каждой платформы:

Для каждого приложения Android:

• Идентификатор приложения Android , объявленный в файле build.gradle приложения.
• Отпечатки SHA256 сертификата подписи.
• (Рекомендуется) Вход пользователя в систему осуществляется с помощью Credential Manager API .

Для каждого сайта:

• Возможность публикации файла /.well-known/assetlinks.json в каждом соответствующем домене в соответствии с синтаксисом ссылок на цифровые активы (DAL) .
• Все домены управления учетными записями (формы входа, регистрации, изменения пароля или сброса пароля) должны быть доступны через HTTPS.

Примечание. Хотя Chrome автоматически передает сохраненные учетные данные между веб-сайтами одного сайта (например, www.example.com и m.example.com ), обмен данными между веб-сайтами и приложениями Android (включая App WebViews) ведется по-разному. Для интеграции приложения необходимо настроить ссылки на цифровые активы (DAL), разместив действительный файл assetlinks.json по адресу /.well-known/assetlinks.json в каждом поддомене, с которым взаимодействует ваше приложение, чтобы включить совместное использование учетных данных.

Обеспечьте беспрепятственный обмен учетными данными между приложениями и веб-сайтами Android.

Чтобы настроить беспрепятственный обмен учетными данными между приложениями и веб-сайтами, вы создаете и публикуете списки утверждений о ссылках на цифровые активы, в которых указывается, каким объектам (веб-сайтам или приложениям Android) разрешено обмениваться учетными данными.

Важно! Менеджер паролей рассматривает отношения совместного использования учетных данных как транзитивные.

Чтобы объявить отношения совместного использования учетных данных:

1. Создайте файл assetlinks.json с инструкциями, ссылающимися на веб-сайт и приложение Android, следуя синтаксису списка операторов DAL :

   [
     {
       "relation":[
         "delegate_permission/common.get_login_creds"
       ],
       "target":{
         "namespace":"web",
         "site":URL
       }
     },
     {
       "relation":[
         "delegate_permission/common.get_login_creds"
       ],
       "target":{
         "namespace":"android_app",
         "package_name":"APP_ID",
         "sha256_cert_fingerprints":[
           "SHA_HEX_VALUE"
         ]
       }
     }
   ]
   

   Где URL — это URL-адрес вашего сайта, APP_ID — идентификатор вашего приложения Android , а SHA_HEX_VALUE — отпечаток SHA256 вашего сертификата подписи приложения Android.

   Поле relation описывает объявляемое отношение. Чтобы объявить, что приложения и сайты используют общие учетные данные для входа, укажите отношения как delegate_permission/common.get_login_creds . Узнайте больше о строках отношений в DAL .

   target поле — это объект, определяющий актив, к которому применяется декларация.

   Следующие поля идентифицируют веб-сайт:

   namespace

   web

   site

   URL-адрес веб-сайта в формате https://domain[:optional_port ]; например, https://www.example.com. domain должен быть полным, а optional_port должен быть опущен при использовании порта 443 для HTTPS. Целевым site может быть только корневой домен: вы не можете ограничить связь приложения определенным подкаталогом. Не включайте в URL-адрес путь, например косую черту. Субдомены не считаются совпадающими: то есть, если вы укажете domain как www.example.com, домен www.counter.example.com не будет связан с вашим приложением.

   Следующие поля идентифицируют приложение Android:

   пространство имен	android_app
   имя_пакета	Имя пакета, объявленное в манифесте приложения. Например, com.example.android
   sha256_cert_fingerprints	Отпечатки SHA256 сертификата подписи вашего приложения.

   Важно! При обеспечении беспрепятственного обмена учетными данными между веб-сайтом и приложением Android мы включаем самоссылающееся заявление в файл assetlinks.json веб-сайта. Это необходимо, поскольку манифест приложения Android ссылается на этот файл на последующих этапах настройки, чтобы включить совместное использование паролей.

2. Разместите файл JSON цифровых активов в следующем месте в доменах для входа: https:// DOMAIN [: OPTIONAL_PORT ]/.well-known/assetlinks.json , где DOMAIN является полным, а OPTIONAL_PORT необходимо опустить при использовании порта 443 для HTTPS.

   Примечание. JSON-файл ссылок на цифровые активы должен отображаться как Content-Type: application/json в заголовках HTTP и не может быть перенаправлением (см. Создание списка операторов ).

3. Объявите связь в приложении Android, внедрив оператор в файл res/values/strings.xml вашего приложения Android, который ссылается на список операторов, созданный на шаге 1. Добавьте объект, указывающий файлы assetlinks.json для загрузки. Например:

     <string name="asset_statements" translatable="false">
   [{
     \"include\": \"https://DOMAIN[:OPTIONAL_PORT]/.well-known/assetlinks.json\"
   }]
   </string>
   

   Замените DOMAIN и OPTIONAL_PORT (необходимо опустить при использовании порта 443 для HTTPS) — например https://www.example.com . Избегайте любых апострофов и кавычек, которые вы используете в строке.

   Вы также можете добавить фрагмент JSON в файл strings.xml , как показано в документации DAL , но использование оператора include позволяет изменять операторы без публикации новой версии вашего приложения .

4. Создайте ссылку на оператор в манифесте, добавив следующую строку в файл AndroidManifest.xml вашего приложения в разделе <application> :

   <meta-data android:name="asset_statements" android:resource="@string/asset_statements"/>
   

5. Опубликуйте новую версию своего приложения для Android в консоли разработчика Google Play.

   Важно! Беспрепятственный обмен учетными данными вступит в силу только после публикации новой версии приложения Android, содержащей ссылку на файл assetlinks.json , размещенный на вашем веб-сайте.

Выполнив эти шаги, вы успешно настроили беспрепятственный обмен учетными данными между вашим веб-сайтом и приложением Android.

Обратите внимание, что это не единственный действительный способ настройки DAL для совместного использования учетных данных, но этот подход упрощает будущий процесс добавления новых объектов в вашу бесшовную сеть совместного использования учетных данных, способствует повторному использованию кода и снижает вероятность ошибок во время обновлений.