액세스 인증
합법적인 사용 사례가 있는 비즈니스만 다른 비즈니스의 비즈니스 데이터에 액세스할 수 있도록 일부 API 엔드포인트는 비즈니스에서 개발 또는 요청한 앱 또는 아직 비즈니스에 연결되지 않은 비즈니스 앱에서 호출한 경우 인증 확인을 수행합니다. 앱을 개발 또는 요청했거나 앱에 연결된 비즈니스가 기술 제공업체로 인증된 경우 해당 엔드포인트가 정상적으로 요청을 처리합니다. 그러나 비즈니스가 기술 제공업체로 인증되지 않은 경우에는 해당 엔드포인트가 호출을 거부하고 오류를 반환합니다.
액세스 인증은 비즈니스가 기술 제공업체로 운영되는지 여부를 확인하는 데 사용되는 절차입니다.
권한
인증 확인
비즈니스에서 요청한 앱이 위에 나열된 임의 권한이 필요한 엔드포인트를 호출할 경우 엔드포인트에서는 먼저 권한이 부여된 사용자가 앱 자체에서 역할이 부여되었는지 확인합니다. 사용자가 앱에서 역할이 부여된 경우 엔드포인트는 호출을 수락하고 계속해서 요청을 처리합니다.
하지만 사용자가 앱에서 역할이 부여되지 않은 경우 엔드포인트는 앱을 요청한 비즈니스가 기술 제공업체로 인증되었는지 확인합니다. 비즈니스가 기술 제공업체로 인증된 경우 엔드포인트는 요청을 정상적으로 처리합니다. 그렇지 않을 경우 엔드포인트는 호출을 거부하고 다음과 같은 오류를 반환합니다.
- 오류 코드:
100 - 설명:
Unsupported get request. Object with ID{object-id}does not exist, cannot be loaded due to missing permissions, or does not support this operation.
오류 코드에 대한 자세한 내용은 마케팅 API 오류 코드 문서를 참조하세요.
인증 확인은 앱을 요청한 비즈니스에 대해 수행되지만, 이는 비즈니스가 요청한 앱이 인증 확인을 구현한 엔드포인트를 호출하는 경우에만 트리거됩니다. 즉, 비즈니스가 기술 제공업체로 인증받은 경우 비즈니스가 요청하는 앱이 인증 확인을 통과하게 됩니다.
액세스 인증을 완료하는 방법
새 앱을 요청하는 인증되지 않은 기술 제공업체 비즈니스의 비즈니스 운영자는 앱 관리자가 위에 나열된 임의의 권한에 대해 고급 액세스 권한을 요청할 때마다 액세스 인증 요구 사항에 대한 이메일 알림을 받게 됩니다.
이메일에 인증 양식에 대한 링크가 포함되어 있지만 기본 > 인증 > 액세스 인증 패널의 앱 대시보드에서도 양식에 액세스할 수 있습니다.
인증을 완료하려면 비즈니스에 대한 관리자 액세스 권한이 있는 사용자가 비즈니스에서 다른 비즈니스에 서비스를 제공하기 위해 해당 비즈니스의 데이터를 사용하는 방법을 분류하고 설명해야 합니다.
비즈니스 운영자가 절차를 완료하고 나면 약 5일 이내에 결과가 결정됩니다.
비즈니스가 기술 제공업체로 인증된 경우 비즈니스 운영자는 확인 이메일을 수신하고 앱 관리자는 확인 개발자 알림을 받게 됩니다. 인증된 비즈니스는 다시 인증받을 필요가 없지만 특정 상황에서는 비즈니스가 일시적으로 인증 상태를 상실할 수 있습니다.
비즈니스가 기술 제공업체 인증을 거부한 경우 비즈니스 운영자는 거부 이메일을 수신하고 앱 관리자는 거부 개발자 알림을 받게 됩니다. 또한 앱 사용자가 호출을 보내는 앱에서 역할이 부여되지 않은 경우 위의 권한이 필요한 엔드포인트로 보내는 모든 호출이 실패합니다.
거부된 비즈니스의 사용 사례가 변경될 경우 비즈니스 운영자가 다시 액세스 인증 절차를 완료하면 재고될 수 있습니다.
필수 조건
비즈니스 운영자가 액세스 인증 프로세스를 시작하기 전에:
기존 비즈니스
다른 비즈니스에서 사용하고 위의 임의 권한이 필요한 앱을 이미 요청한 비즈니스 운영자에게 액세스 인증 요구 사항에 대한 이메일이 자동으로 전송됩니다. 앱 관리자도 이 요구 사항에 대한 개발자 알림을 수신하게 됩니다.
이메일이 전송되고 나면 비즈니스 운영자는 60일 이내에 인증 절차를 완료해야 합니다. 60일 이내에 액세스 인증 절차를 완료하지 않은 경우 위의 임의 권한이 필요한 엔드포인트로 보내는 모든 호출은 점진적으로 인증 확인을 받게 됩니다.