승인 과정 중에 Google OAuth가 오류를 반환할 수 있습니다. 이 가이드를 사용하여 이 프로세스 중 가장 일반적인 오류를 해결하세요.
문제 해결
Google OAuth에 대한 자세한 내용은 OAuth 2.0을 사용하여 Google API에 액세스를 참조하세요.
갱신 토큰이 계속 만료됨
한 가지 원인으로 클라이언트 ID가 승인되지 않으면 갱신 토큰의 작동이 7일 후에 중지될 수 있습니다. 7일 토큰 만료는 상업용 또는 샌드박스 승인과 관련이 없습니다. 토큰 수명을 늘리려면 서비스 또는 사용자 계정에서 OAuth 2.0 클라이언트 ID를 승인받고 프로덕션에 적용해야 합니다. 자세한 내용은 갱신 토큰 만료를 참조하세요.
액세스가 거부됨
Google Cloud에서 OAuth 동의 화면을 설정했고 사용자 유형이 외부인 경우, 앱의 테스트 사용자로 등록되지 않은 Google 계정과의 계정 연결을 시도하면 '액세스 거부됨' 오류가 발생합니다. Google 계정을 OAuth 동의 화면의 테스트 사용자 섹션에 추가해야 합니다.
파트너 연결 관리자 (PCM) 오류
PCM에 액세스할 때 발생하는 오류에 관한 도움말은 파트너 연결 관리자 (PCM) 오류 참조를 확인하세요.
Google에서 확인하지 않은 앱
SDM API는 제한된 범위를 사용합니다. 즉, OAuth API 인증을 완료하지 않으면 승인 중에 이 범위를 사용하는 모든 앱이 '확인되지 않습니다'. 개인용 Device Access 을 사용하는 경우 OAuth API 인증이 필요하지 않습니다.
Google Cloud의 OAuth 동의 화면에 sdm.service 범위가 구성되지 않은 경우 승인 프로세스 중에 'Google에서 확인하지 않은 앱' 화면이 표시될 수 있습니다. 이 화면은 고급 옵션을 클릭한 후 프로젝트 이름으로 이동 (안전하지 않음)을 클릭하여 우회할 수 있습니다.
자세한 내용은 확인되지 않은 앱 화면을 참고하세요.
잘못된 클라이언트
액세스 또는 갱신 토큰을 가져올 때 잘못된 OAuth 2.0 클라이언트 보안 비밀번호를 제공하면 '잘못된 클라이언트' 오류가 발생합니다. 액세스 및 갱신 토큰 호출에서 사용 중인 client_secret 값이 Google Cloud 사용자 인증 정보 페이지에 나와 있는 사용 중인 OAuth 2.0 클라이언트 ID의 값인지 확인합니다.
요청이 잘못되었습니다. 필수 범위가 누락되었습니다.
PCM에서 권한을 부여한 후 '필수 매개변수 누락: 범위'라는 '잘못된 요청' 오류가 발생할 수 있습니다. 승인 호출에 사용하는 scope 값이 Google Cloud 사용자 인증 정보 페이지에 표시된 OAuth 2.0 클라이언트에 설정한 값과 동일한지 확인합니다.
리디렉션 URI 불일치
승인 진행 시 '리디렉션 URI 불일치' 오류가 발생할 수 있습니다. 승인 호출에 사용하는 redirect_uri 값이 Google Cloud 사용자 인증 정보 페이지에 있는 OAuth 2.0 클라이언트에 설정한 값과 동일한지 확인합니다.
빠른 참조
이 참조를 사용하여user 를 승인하고 Google 계정을 연결하는 단계를 빠르게 구현하세요.
이 빠른 참조를 사용하려면 코드 샘플에서 특정 통합에 해당하는 값으로 각 자리표시자 변수를 수정하고 필요에 따라 복사하여 붙여넣습니다.
1 PCM
user 를 앱의 PCM 링크로 전달하고 다음을 바꿉니다.
- Device Access Project 신분증으로 project-id
- oauth2-client-id를 Google Cloud 사용자 인증 정보의 OAuth2 클라이언트 ID로 바꿉니다.
- redirect-uri를 사용 중인 OAuth2 클라이언트 ID에 대해 지정된 리디렉션 URI로 바꿉니다.
- 사용 가능한 범위 중 하나로 scope
https://nestservices.google.com/partnerconnections/project-id/auth?redirect_uri=redirect-uri& access_type=offline& prompt=consent& client_id=oauth2-client-id& response_type=code& scope=https://www.googleapis.com/auth/scope
인증 코드 2개
선택한 범위에 대해 PCM을 통해 권한을 부여한 후에는 user 이 지정된 리디렉션 URI로 리디렉션되어야 합니다. 승인 코드는 URL에서 code 매개변수로 반환되며 형식은 다음과 같습니다.
redirect-uri?code=authorization-code&scope=https://www.googleapis.com/auth/scope
3 액세스 토큰
승인 코드를 사용하여 액세스 토큰을 가져옵니다. 이 액세스 토큰은 사용자 대신 SDM API를 호출하는 데 사용할 수 있습니다.
Google의 OAuth 엔드포인트에 POST 호출을 수행하여 다음을 바꿉니다.
- oauth2-client-id 및 oauth2-client-secret를 Google Cloud 사용자 인증 정보의 OAuth2 클라이언트 ID 및 클라이언트 보안 비밀번호로 바꿉니다.
- authorization-code를 이전 단계에서 받은 코드로 바꿉니다.
- redirect-uri를 사용 중인 OAuth2 클라이언트 ID에 대해 지정된 리디렉션 URI로 바꿉니다.
Google OAuth는 액세스 토큰과 갱신 토큰 등 두 가지 토큰을 반환합니다.
요청
curl -L -X POST 'https://www.googleapis.com/oauth2/v4/token?client_id=oauth2-client-id&client_secret=oauth2-client-secret&code=authorization-code&grant_type=authorization_code&redirect_uri=redirect-uri'
응답
{
"access_token": "access-token",
"expires_in": 3599,
"refresh_token": "refresh-token",
"scope": "https://www.googleapis.com/auth/scope",
"token_type": "Bearer"
}
4 API 호출
승인은 user의 액세스 토큰을 사용하여 API를 호출할 때까지 완료되지 않습니다. 이 초기 호출은 승인 프로세스를 완료하고 이벤트를 사용 설정합니다.
지정된 범위에 나열된 API 호출 중 하나를 사용해야 승인을 완료할 수 있습니다.
sdm.service
기기
자세한 내용은 devices.list API 참조를 확인하세요.
curl -X GET 'https://smartdevicemanagement.googleapis.com/v1/enterprises/project-id/devices' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer access-token'5 갱신 토큰
SDM API의 액세스 토큰은 Google OAuth에서 반환하는 expires_in 매개변수에 나와 있는 것처럼 1시간 동안만 유효합니다. 액세스 토큰이 만료되면 갱신 토큰을 사용하여 새 토큰을 받으세요.
Google의 OAuth 엔드포인트에 POST 호출을 수행하여 다음을 바꿉니다.
- oauth2-client-id 및 oauth2-client-secret를 Google Cloud 사용자 인증 정보의 OAuth2 클라이언트 ID 및 클라이언트 보안 비밀번호로 바꿉니다.
- refresh-token을 액세스 토큰을 처음 가져올 때 받은 코드로 바꿉니다.
Google OAuth가 새 액세스 토큰을 반환합니다.
요청
curl -L -X POST 'https://www.googleapis.com/oauth2/v4/token?client_id=oauth2-client-id&client_secret=oauth2-client-secret&refresh_token=refresh-token&grant_type=refresh_token'
응답
{
"access_token": "new-access-token",
"expires_in": 3599,
"scope": "https://www.googleapis.com/auth/scope",
"token_type": "Bearer"
}