OAuth 기반 앱 플립 연결 (App Flip)을 사용하면 사용자가 인증 시스템의 계정을 Google 계정에 쉽고 빠르게 연결할 수 있습니다. 계정 연결 절차를 시작할 때 앱이 사용자 휴대전화에 설치되면 앱으로 원활하게 전환하여 사용자 승인을 받을 수 있습니다.
이 접근 방식은 사용자가 사용자 이름과 비밀번호를 다시 입력하지 않아도 되므로 더 ��르��� ���운 연결 프로세스를 제공합니다. 대신 앱 플립이 앱에서 사용자 계정의 사용자 인증 정보를 활용합니다. 사용자는 Google 계정을 앱에 연결하면 개발한 통합 기능을 활용할 수 있습니다.
앱 플립은 iOS 앱과 Android 앱 모두에 설정할 수 있습니다.
![이 그림은 사용자가 Google 계정을 인증 시스템에 연결하는 단계를 보여줍니다. 첫 번째 스크린샷은 Google 계정이 앱에 연결된 경우 사용자가 앱을 선택하는 방법을 보여줍니다. 두 번째 스크린샷은 Google 계정을 앱과 연결하기 위한 확인을 보여줍니다. 세 번째 스크린샷은 Google 앱에서 성공적으로 연결된 사용자 계정을 보여줍니다.](https://cdn.statically.io/img/developers.google.com/static/identity/images/app-flip-flow.png?hl=ko)
요구사항
앱 플립을 구현하려면 다음 요구사항을 충족해야 합니다.
- Android 또는 iOS 앱이 있어야 합니다.
- OAuth 2.0 승인 코드 흐름을 지원하는 OAuth 2.0 서버를 소유, 관리, 유지해야 합니다.
OAuth 연결 승인 코드 흐름에 대한 자세한 내용은 OAuth 서버 구현을 참조하세요.
디자인 가이드라인
이 섹션에서는 앱 플립 계정 연결 동의 화면의 설계 요구사항과 권장사항을 설명합니다. Google에서 앱을 호출하면 앱에서 사용자에게 동의 화면을 표시합니다.
요구사항
- 사용자의 계정이 Google Home이나 Google 어시스턴트와 같은 특정 Google 제품이 아니라 Google에 연결되어 있음을 알려야 합니다.
권장사항
다음을 수행하는 것이 좋습니다.
Google 개인정보처리방�� 표시. 동의 화면에 Google 개인정보처리방침 링크를 포함하세요.
공유할 데이터. Google에 필요한 데이터와 그 이유를 사용자에게 명확하고 간결하게 안내합니다.
명확한 클릭 유도문안. 동의 화면에 '동의 및 연결'과 같은 명확한 클릭 유도 문구를 표시하세요. 계정을 연결하려면 사용자가 Google과 어떤 데이터를 공유해야 하는지 파악해야 하기 때문입니다.
취소 기능. 사용자가 연결하지 않기로 선택한 경우 뒤로 돌아가거나 취소할 수 있는 방법을 제공합니다.
연결 해제 기능. 사용자가 연결 해제할 수 있는 메커니즘(예: 플랫폼의 계정 설정 URL)을 제공합니다. 또는 사용자가 연결된 계정을 관리할 수 있는 Google 계정 링크를 포함할 수 있습니다.
사용자 계정 변경 기능. 사용자에게 계정을 전환하는 방법을 제안합니다. 사용자가 여러 계정을 보유하는 경우 특히 유용합니다.
- 사용자가 동의 화면을 닫아 계정을 전환해야 하는 경우 OAuth 연결 및 암시적 절차로 원하는 계정에 로그인할 수 있도록 복구 가능한 오류를 Google에 전송하세요.
로고를 포함합니다. 동의 화면에 회사 로고를 표시합니다. 스타일 가이드라인을 사용해 로고를 배치하세요. Google의 로고도 표시하려면 로고 및 상표를 참조하세요.
![이 그림은 사용자 동의 화면을 설계할 때 따라야 할 개별 요구사항과 권장사항을 표시하는 동의 화면의 예를 보여줍니다.](https://cdn.statically.io/img/developers.google.com/static/identity/images/app-flip-guidance.png?hl=ko)
OAuth 기반 앱 플립 설정
다음 섹션에서는 OAuth 기반 앱 플립을 위한 기본 요건과 작업 콘솔에서 앱 플립 프로젝트를 구성하는 방법을 설명합니다.
작업을 만들고 OAuth 2.0 서버를 설정합니다.
앱 플립을 구성하려면 다음을 실행해야 합니다.
- 작업을 만듭니다. 작업을 만들려면 프로젝트 만들기 섹션의 안내를 따르세요.
- OAuth 2.0 서버를 설정합니다. OAuth 서버 설정에 관한 자세한 내용은 OAuth 계정 연결 구현을 참조하세요.
Actions 콘솔에서 앱 플립 구성
다음 섹션에서는 작업 콘솔에서 앱 플립을 구성하는 방법을 설명합니다.
- 상단 탐색 메뉴에서 Develop을 클릭합니다. 그런 다음 왼쪽 탐색 메뉴에서 계정 연결을 클릭합니다.
- 계정 연결 옆에 있는 스위치를 켭니다.
- 계정 생성에서 아니요, 웹사이트에서 계정 생성만 허용하고 싶습니다를 선택합니다.
- 다음을 클릭합니다.
- 연결 유형의 드롭다운 메뉴에서 OAuth 및 승인 코드를 선택합니다.
- 다음을 클릭합니다.
- OAuth 클라이언트 정보 아래의 모든 입력란을 작성합니다. 앱 플립이 지원되지 않는 경우 일반 OAuth가 대체 방안으로 사용됩니다.
- 다음을 클릭합니다.
- 계정 연결에 앱 사용 (선택사항)에서 iOS에 사용 설정을 선택합니다.
- 범용 링크 입력란을 작성합니다. 범용 링크에 대한 자세한 내용은 앱 및 웹사이트에서 콘텐츠에 연결하도록 허용 을 참조하세요.
- 선택적으로 클라이언트를 구성하려면 범위를 추가하고 클라이언트 구성 (선택사항)에서 범위 추가를 클릭합니다. 그렇지 않으면 다음을 클릭합니다.
- 테스트 안내에서
test
(또는 다른 문자열)을 자리표시자로 입력합니다. (게시할 작업을 실제로 제출하는 경우에만 테스트 계정으로 이 필드를 작성해야 합니다.) - 저장을 클릭합니다.
이제 다음 섹션으로 이동하여 iOS 또는 Android 앱에서 앱 플립을 구현할 수 있습니다.
네이티브 앱에서 앱 플립 구현
앱 플립을 구현하려면 Google의 딥 링크를 허용하도록 앱의 사용자 승인 코드를 수정해야 합니다.
기기에서 앱 플립 테스트
이제 콘솔과 앱에서 작업을 만들고 앱 플립을 구성했으므로 휴대기기에서 앱 플립을 테스트할 수 있습니다. Google 어시스턴트 앱을 사용하여 앱 플립을 테스트할 수 있습니다.
어시스턴트 앱에서 앱 플립을 테스트하려면 다음 단계를 따르세요.
- Actions 콘솔로 이동하여 프로젝트를 선택합니다.
- 상단 탐색 메뉴에서 Test(테스트)를 클릭합니다.
- 어시스턴트 앱에서 계정 연결 흐름을 트리거합니다.
- Google 어시스턴트 앱을 엽니다.
- 설정을 클릭합니다.
- 어시스턴트 탭에서 홈 컨트롤을 클릭합니다.
- Add(+)를 클릭합니다.
- 제공업체 목록에서 작업을 선택합니다. 목록에 '[test]' 접두사가 붙습니다. 목록에서 [test] 작업을 선택하면 앱이 열립니다.
- 앱이 실행되었는지 확인하고 승인 흐름 테스트를 시작합니다.