Google Cloud에서 ARCore API 사용

키 없음

키 없는 인증을 사용하여 앱을 승인하려면 OAuth 2.0 클라이언트 ID를 만듭니다.

서명 키 디지털 지문 확인

OAuth 2.0 클라이언트 ID는 앱의 서명 키 지문을 사용하여 앱을 식별합니다.

keytool -list -v -alias androiddebugkey -keystore ~/.android/debug.keystore

keytool -list -v -alias androiddebugkey -keystore %USERPROFILE%\.android\debug.keystore

   Certificate fingerprint: SHA1: <strong>DA:39:A3:EE:5E:6B:4B:0D:32:55:BF:EF:95:60:18:90:AF:D8:07:09

keytool -list -v -alias your-key-name -keystore path-to-production-keystore

   Certificate fingerprint: SHA1: DA:39:A3:EE:5E:6B:4B:0D:32:55:BF:EF:95:60:18:90:AF:D8:07:09

OAuth 2.0 클라이언트 ID 만들기

이전 단계의 적용 가능한 서명 키마다 Google Cloud 프로젝트의 사용자 인증 정보에서 OAuth 2.0 클라이언트 ID를 만듭니다.

• Google Cloud에서 사용자 인증 정보 페이지를 엽니다.

  사용자 인증 정보

• 사용자 인증 정보 만들기를 클릭한 후 메뉴에서 OAuth 클라이언트 ID를 선택합니다.

• 다음과 같이 필수 입력란을 작성합니다.

  • 애플리케이션 유형: Android를 선택합니다.
  • Package name: AndroidManifest.xml에 선언된 패키지 이름을 사용합니다.
  • SHA-1 인증서 지문: 이전 단계에서 가져온 지문을 사용합니다.

• 만들기를 누릅니다.

필수 라이브러리 포함

1. 앱의 종속 항목에 com.google.android.gms:play-services-auth:16+를 포함합니다.

2. 코드 압축을 사용하는 경우 앱의 build.gradle 파일에 추가합니다.

   buildTypes {
     release {
       ...
       proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
     }
   }
   

3. 앱의 proguard-rules.pro 파일에 다음을 추가합니다.

   -keep class com.google.android.gms.common.** { *; }
   -keep class com.google.android.gms.location.** { *; }
   -keep class com.google.android.gms.auth.** { *; }
   -keep class com.google.android.gms.tasks.** { *; }
   

이제 앱이 키 없는 인증을 사용하도록 구성되었습니다.

키 없음

ARCore는 iOS에서 JSON 웹 토큰을 사용하여 API 호출 승인을 지원합니다. 토큰은 Google 서비스 계정에서 서명해야 합니다.

iOS용 토큰을 생성하려면 다음 요구사항을 충족하는 엔드포인트가 서버에 있어야 합니다.

• 자체 승인 메커니즘이 엔드포인트를 보호해야 합니다.

• 엔드포인트는 다음과 같이 매번 새 토큰을 생성해야 합니다.

  • 각 사용자는 고유한 토큰을 받습니다.
  • 토큰은 즉시 만료되지 않습니다.

서비스 계정 및 서명 키 만들기

Google 서비스 계정과 서명 키를 만들려면 다음 단계를 따르세요.

1. Google Cloud에서 사용자 인증 정보 페이지를 엽니다.
   사용자 인증 정보
2. 사용자 인증 정보 만들기 > 서비스 계정을 클릭합니다.
3. 서비스 계정 세부정보에서 새 계정의 이름을 입력한 후 만들기를 클릭합니다.
4. 서비스 계정 권한 페이지에서 역할 선택 드롭다운으로 이동합니다. 서비스 계정 > 서비스 계정 토큰 생성자를 선택한 다음 계속을 클릭합니다.
5. 사용자에게 이 서비스 계정에 대한 액세스 권한 부여 페이지에서 완료를 클릭합니다.
6. 사용자 인증 정보 페이지에서 서비스 계정 섹션을 찾아 방금 만든 계정의 이름을 클릭합니다.
7. 서비스 계정 세부정보 페이지에서 키 섹션까지 아래로 스크롤하고 키 추가 > 새 키 만들기를 선택합니다.

8. 키 유형으로 JSON을 선택하고 만들기를 클릭합니다.

   그러면 비공개 키가 포함된 JSON 파일이 머신에 다운로드됩니다. 다운로드한 JSON 키 파일을 안전한 위치에 저장합니다.

서버에서 토큰 만들기

서버에서 새 토큰 (JWT)을 만들려면 표준 JWT 라이브러리와 새 서비스 계정에서 안전하게 다운로드한 JSON 파일을 사용합니다.

개발 머신에서 토큰 만들기

개발 머신에서 JWT를 생성하려면 다음 oauth2l 명령어를 사용합니다.

oauth2l fetch --cache "" --jwt --json $KEYFILE --audience "https://arcore.googleapis.com/"

매번 다른 토큰이 생성되도록 하려면 --cache 플래그를 사용하여 빈 캐시 위치를 지정해야 합니다. 결과 문자열을 잘라야 합니다. 추가 공백이나 줄바꿈 문자로 인해 API에서 토큰을 거부합니다.

토큰 서명

JWT에 서명하려면 RS256 알고리즘과 다음 클레임을 사용해야 합니다.

• iss - 서비스 계정 이메일 주소입니다.
• sub - 서비스 계정 이메일 주소입니다.
• iat - 토큰이 생성된 유닉스 시간(초)입니다.
• exp — iat + 3600 (1시간) 토큰이 만료되는 유닉스 시간(초)입니다.
• aud - 잠재고객입니다. https://arcore.googleapis.com/로 설정해야 합니다.

JWT 페이로드에는 비표준 클레임이 필요하지 않지만 uid 클레임이 해당 사용자를 식별하는 데 유용할 수 있습니다.

Google에서 관리하는 환경에서 Google API를 사용하는 등 다른 방법으로 JWT를 생성하는 경우 이 섹션의 클레임으로 JWT에 서명해야 합니다. 무엇보다도 독자층이 정확한지 확인해야 합니다.

ARCore 세션에서 토큰 전달

1. iOS 인증 전략이 AuthenticationToken으로 설정되어 있는지 확인합니다. Unity에서 Edit(수정) > Project Settings(프로젝트 설정) > XR Plug-in Management(XR 플러그인 관리) > ARCore Extensions(ARCore 확장)로 이동합니다. iOS 인증 전략 드롭다운 메뉴에서 인증 토큰 옵션을 선택합니다.

2. 토큰을 받으면 ARAnchorManager.SetAuthToken()을 사용하여 ARCore 세션에 전달합니다.

   // Designate the token to authorize ARCore API calls
   // on the iOS platform. This should be called each time the application's token is refreshed.
   ARAnchorManager.SetAuthToken(authToken);
   

이제 앱이 키 없는 인증을 사용하도록 구성되었습니다.

토큰을 세션에 전달할 때 다음 사항에 유의하세요.

• API 키를 사용하여 세션을 만든 경우 ARCore에서 토큰을 무시하고 오류를 로깅합니다.

  API 키가 더 이상 필요하지 않으면 Google Developers Console에서 키를 삭제하고 앱에서 삭제합니다.

• ARCore는 공백이나 특수문자가 포함된 토큰을 무시합니다.

• 토큰은 일반적으로 1시간 후에 만료됩니다. 사용 중에 토큰이 만료될 가능성이 있으면 새 토큰을 받아 API에 전달하세요.

API 키

1. Google Cloud에서 사용자 인증 정보 페이지를 엽니다.
   사용자 인증 정보
2. 사용자 인증 정보 만들기를 클릭한 후 메뉴에서 API 키를 선택합니다.
   API 키 생성 완료 대화상자에 새로 만든 키의 문자열이 표시됩니다.

3. Unity에서 Edit(수정) > Project Settings(프로젝트 설정) > XR Plug-in Management(XR 플러그인 관리) > ARCore Extensions(ARCore 확장)로 이동합니다. 각 타겟 플랫폼 (Android, iOS)의 인증 전략 드롭다운 메뉴에서 API 키 옵션을 선택합니다. 그런 다음 API 키 필드에 API 키를 삽입합니다.

4. API 키를 보호하려면 API 키 제한사항에 대한 문서를 검토하세요.

이제 앱이 API 키를 사용하도록 구성되었습니다.