REST API 범위 문제 해결

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 소요 시간: 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, 세션 쿠키 및 인증서 기반 인증은 적용되지 않습니다.
    REST API 호출은 OAuth 액세스 토큰을 사용할 때 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