REST API 범위 문제 해결

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 3분

    • 문제 해결 작업은 REST API 범위를 설정하거나 실행할 때 발생하는 일반적인 문제를 해결하는 데 도움이 될 수 있습니다.

    표 1. 문제 해결
    문제 작업
    REST API는 인증 범위와 연결되지만 런타임에는 전달자 토큰 인증을 사용해도 인증 범위 검사가 없습니다.
    • sys_api_access_policy 기록이 활성 상태인지 확인합니다. 런타임은 비활성 기록을 무시합니다.
    • 속성 com.glide.rest.api.auth.scope.check.enable 이 아니오로 설정되어 있는지 확인하십시오.
    • OAuth 토큰에 사용자 계정 인증 범위가 있는지 확인합니다.
    REST API는 과(와) auth_scope1연결되어 있지만 이를 가진 auth_scope2 액세스 토큰도 액세스할 수 있습니다.
    • 이 기록이 활성 상태인지 확인합니다.
    • 이 REST를 확인하고 API는 동일하지만 다른 적용 메서드, 버전 또는 자원이 다른 기록이 있는지 확인합니다.
    REST API는 인증 범위와 연결되지만 런타임에는 및 에 mutualAuth대한 basicAuth 인증 범위 검사가 없습니다. REST API 인증 범위가 OAuth 액세스 토큰 또는 OIDC 토큰에만 적용되기 때문에 예상되는 일입니다. BasicAuth, 세션 쿠키 및 인증서 기반 인증은 적용하지 않습니다.
    OAuth 액세스 토큰을 사용할 때 REST API 호출은 403을 반환합니다. "필수 API 액세스 범위 누락"이라는 오류 메시지를 확인합니다. 발견되면 이 REST API에 대한 인증 범위 확인에 실패합니다.
    미리 정의된 사용자 계정 이 삭제되었으며 재개할 수 없습니다. 다른 인스턴스에서 사용자 계정을xml 로 익스포트하고 임포트하거나 사용자 계정을 만들고 시스템 속성을 glide.oauth.token.scope.useraccount 새로 만든 sys_id 기록으로 수정합니다.

    자주 묻는 질문

    다음은 REST API 인증 범위를 사용할 때 자주 묻는 질문입니다.

    하나의 OAuth 토큰을 여러 인증 범위와 연결할 수 있습니까?
    예, 하나의 oauth_entity 를 여러 인증 범위와 연결할 수 있으며 이 oauth_entity 에서 발급한 모든 OAuth 토큰에는 동일한 인증 범위가 있습니다.
    인증 범위가 다른 다른 OAuth 토큰이 동일한 REST API에 액세스할 수 있습니까?
    예, 동일한 REST API의 경우 다른 인증 범위에서 액세스할 수 있습니다. 하나의 인증 범위가 일치하면 인증 범위가 결과를 반환합니다.
    사용자 계정 인증 범위가 있는 OAuth 액세스 토큰이 모든 REST API에 액세스할 수 있습니까?
    예, 사용자 계정 은 인증 범위에 대한 전체 액세스 권한을 갖습니다.
    OAuth 접근 토큰 OAuth 범위를 동적으로 변경할 수 있습니까?
    예. 인증 범위가 oauth_credential 테이블의 액세스 토큰으로 하드 코딩되지 않았습니다. 대신 런타임 중에 연결된 oauth_entity 에서 인증 범위를 가져옵니다.
    새로 고침 후 OAuth 토큰이 동일한 인증 범위를 유지할 수 있습니까?
    예, oauth_entity와 연결된 인증 범위를 수정하지 않는 한 토큰 새로 고침 후oauth_admin 인증 범위가 변경되지 않습니다.
    미리 정의된 사용자 계정 인증 범위 기록이 삭제된 경우 사용자 계정 이라는 이름으로 새 인증 범위를 만들 수 있습니까?
    동일한 사용자 계정 으로 새 인증 범위를 만드는 것은 작동하지 않습니다. 런타임에서 이름 대신 sys_id 를 사용하여 인증 범위 검사를 수행하고 시스템 속성을 glide.oauth.token.scope.useraccount 새로 생성된 sys_id 기록으로 수정합니다.
    관리자가 oauth_entity와 연결된 인증 범위를 수정하는 경우 이 OAuth 엔터티에서 발급한 기존 OAuth 액세스 토큰도 모두 변경됩니까?
    예, 인증 범위는 OAuth 액세스 토큰과 직접 연결되지 않으며 런타임 중에 oauth_entity 에서 가져옵니다.
    동일한 oauth_entity 에서 발급한 다른 OAuth 액세스 토큰이 다른 인증 범위를 가질 수 있습니까?
    아니요, 토큰에 대한 모든 액세스는 동일한 oauth_entity 에서 발급되며 항상 동일한 인증 범위를 갖습니다.
    사용자가 특정 엔드포인트에 대해 서로 다른 인증 범위를 정의할 수 있습니까?
    아니요, 특정 REST API 엔드포인트에 대한 고유한 제약 조건 검사가 있습니다. 그러나 동일한 REST API 엔드포인트의 경우 일치하는 인증 범위가 두 개 이상 있을 수 있습니다.
    인증 범위 검사는 BasicAuth에도 사용됩니까?
    아니요, 인증 범위 검사는 OAuth 액세스 토큰 및 OIDC 토큰일 뿐이며 적용되지 않습니다.basicAuthmutualAuth