'통합 권한 요청' 오류 해결

앱을 HubSpot에 연결하려고 할 때 ‘통합 권한 요청’ 오류가 발생할 수 있습니다. 이 오류는 앱이 HubSpot에 연결하기 위해 특정 사용자 역할이나 계정 전체 권한이 필요할 때 발생합니다.

이 문서에서는 앱을 연결할 때 발생할 수 있는 가장 일반적인 권한 오류와 각 오류를 해결하여 연결을 성공적으로 완료하는 방법을 설명합니다.

연결을 완료할 수 없습니다: 제공된 권한 범위가 불충분하여 인증에 실패했습니다. 앱 개발자에게 문의하십시오.

오류 의미

이 오류는 앱 구성에 필수 범위가 포함되어 있지만, 앱 설치 URL의 scope 쿼리 매개변수에서 해당 범위가 누락된 경우 발생합니다. optional_scope 매개변수에 필수 범위를 포함하는 경우에도 이 오류가 발생합니다.

오류 해결 방법

이 문제를 해결하려면 앱 개발자가 모든 설치 URL에 앱 구성에서 선택한 필수 범위가 모두 포함되도록 해야 합니다.

연결을 완료할 수 없습니다: 설치 URL의 범위와 앱의 구성된 범위 간에 불일치가 있어 인증에 실패했습니다. 앱 개발자에게 문의하십시오.

오류의 의미

다음과 같은 상황이 발생하면 사용자에게 이 오류가 표시될 수 있습니다.

• 앱의 설치 URL에 앱 설정에 구성되지 않은 조건부 필수 또는 선택적 범위가 포함되어 있는 경우.
• 앱 설치 URL의 optional_scope 쿼리 매개변수에 조건부 필수 범위가 포함되어 있는 경우.
• 앱의 설치 URL에 있는 scope 매개변수에 선택적 범위가 잘못 포함되어 있는 경우입니다. 예를 들어, 앱 설정에서 crm.objects.custom.read 범위가 선택적 범위로 구성되어 있지만, 제공된 설치 URL이 /authorize?client_id=123&redirect_uri=xyz&scope=crm.objects.custom.read 인 경우 이 오류가 발생합니다.

오류 해결 방법

이 오류를 해결하려면 앱 개발자는 앱 설정에서 스코프를 '조건부 필수' 또는 '선택적'으로 올바르게 구성했는지 확인해야 합니다. 그런 다음, 앱 설치 URL의 관련 scope 및 optional_scope 쿼리 매개변수 아래에 각 스코프가 나열되어 있는지 확인하십시오.

연결을 완료할 수 없습니다. 이 통합 기능을 연결할 권한이 없습니다.

오류 의미

연동을 연결하려는 HubSpot 사용자에게는 연동에서 요청한 필수 범위를 승인하는 데 필요한 사용자 역할이나 권한이 없습니다.

오류 해결 방법

이 오류를 해결하려면 통합을 연결하는 사용자에게 App Marketplace의 ' ' 권한이 있어야 합니다. 이 권한을 통해 사용자는 HubSpot 계정을 위해 HubSpot App Marketplace에서 앱을 연결하고 설치할 수 있습니다. 이 권한을 부여해도 오류가 해결되지 않으면, 해당 사용자에게' ' 슈퍼 관리자 권한을 할당해야 합니다.

또한 통합을 연결하는 사용자는 App Marketplace의 앱 목록 페이지에서 ‘요구 사항 > HubSpot 계정 권한’ 항목에 나열된 모든 권한을 보유하고 있는지 확인해야 합니다.

일반적으로 누락된 권한은 ‘속성 설정 편집’ 권한입니다. 대부분의 앱은 HubSpot 개체에서 속성을 생성하거나 업데이트하기 위해 이 액세스 권한이 필요합니다.

이 계정은 이 통합에 필요한 일부 HubSpot 기능에 대한 액세스 권한이 없습니다. 통합 제공업체에 문의해 주십시오.

오류 의미

통합이 연결하려는 HubSpot 계정에는 통합에서 요청한 범위에 필요한 도구가 없습니다. 예를 들어, Marketing Hub Starter 구독을 사용하는 HubSpot 계정은 워크플로우에 대한 액세스가 필요한 통합을 연결할 수 없습니다.

오류 해결 방법

이 오류를 해결하려면 HubSpot 계정을 필요한 도구에 대한 접근 권한이 있는 구독으로 업그레이드해야 합니다. 계정을 업그레이드하려면 앱 개발자에게 문의하여 해당 통합 기능을 연결하는 데 필요한 구독이 무엇인지 확인하십시오.