클라이언트가 인스턴스에 액세스할 수 있는 엔드포인트 만들기

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기2분
  • 외부 클라이언트 애플리케이션이 인스턴스에 액세스할 ServiceNow 수 있도록 OAuth 애플리케이션 엔드포인트를 생성합니다.

    시작하기 전에

    필요한 역할: 관리자

    프로시저

    1. 다음으로 이동 모두 > 시스템 OAuth > 애플리케이션 레지스트리 을 클릭한 다음 새로 만들기를 클릭합니다.
    2. 인터셉터 페이지에서 외부 클라이언트용 OAuth API 엔드포인트 작성을 클릭한 후 양식을 채웁니다.
      필드 설명
      이름 OAuth 액세스가 필요한 애플리케이션을 식별하는 고유 이름입니다.
      클라이언트 ID [읽기 전용] 애플리케이션의 자동 생성 고유 ID입니다. 인스턴스는 액세스 토큰을 요청할 때 클라이언트 ID를 사용합니다.
      클라이언트 비밀 [필수] 인스턴스와 클라이언트 애플리케이션 또는 웹 사이트 둘 다에서 서로에 대한 통신을 승인하는 데 사용하는 공유 비밀 문자열입니다. 인스턴스는 액세스 토큰을 요청할 때 클라이언트 암호를 사용합니다. 인스턴스가 클라이언트 비밀을 자동으로 생성하려면 이 필드를 비워 두십시오. 기존 클라이언트 암호를 표시하려면 잠금 아이콘을 클릭합니다.
      리디렉션 URL 권한 부여 서버가 리디렉션하는 콜백 URL입니다. 자원에 대한 액세스를 요청하는 클라이언트의 전체 URL을 /oauth_redirect.do에 추가하여 입력합니다. 예: http://token_consumer:port/oauth_redirect.do. 가능한 모든 토큰 소비자에 대해 필요한 만큼 URL을 입력합니다. 인스턴스는 수신 요청의 URL을 리디렉션 URL 중 하나와 일치시킵니다. 일치하는 항목이 없으면 인스턴스가 첫 번째 리디렉션 URL을 사용합니다.
      로고 URL 애플리케이션 로고로 사용할 이미지가 포함된 URL입니다. 로고는 사용자가 인스턴스의 제한된 자원에 대한 클라이언트 애플리케이션 액세스 권한을 부여해 달라는 요청을 받으면 승인 페이지에 나타납니다.
      활성 애플리케이션 레지스트리를 활성화하려면 확인란을 선택합니다.
      새로 고침 토큰 수명 새로 고침 토큰이 유효한 시간(초)입니다. 인스턴스는 새로 고침 토큰을 요청할 때 수명 값을 사용합니다. 기본적으로 새로 고침 토큰은 100일(8640000초) 후에 만료됩니다.
      토큰 제한 적용 인증 프로파일을 허용하도록 설정된 API에서만 토큰을 사용할 수 있도록 하려면 선택합니다. 접근 권한 부여는 API 접근 정책을 사용하여 설정할 수 있습니다. 자세한 내용은 REST API 액세스 정책 만들기를 참조하세요.

      기본값: 선택 취소.

      모바일 클라이언트 모바일 앱 또는 웹에 대한 엔터티를 나타냅니다. 이 정보는 모바일 또는 웹으로 로그인 정보를 분석하는 데 사용됩니다.
      접근 토큰 수명 접근 토큰이 유효한 시간(초)입니다. 인스턴스는 액세스 토큰을 요청할 때 수명 값을 사용합니다. 기본적으로 액세스 토큰은 30분(1,800초) 후에 만료됩니다.
      설명 애플리케이션과 연결할 추가 정보입니다.
      클라이언트 유형 클라이언트 유형에 따라 클라이언트 유형을 선택합니다. 옵션:
      • Iframe 임베디드
      • 사용자형 통합
      • 서비스형 통합
      자세한 내용은 를 참조하십시오 OAuth 및 SSO 기록에 대한 클라이언트 유형 구성.
    3. 제출을 클릭합니다.

    결과

    시스템이 OAuth 클라이언트 유형의 애플리케이션 레지스트리 [oauth_entity] 테이블에 기록을 생성합니다. 인스턴스가 실제로 토큰과 권한 부여 코드를 발급하면 테이블에 저장됩니다. 자세한 내용은 OAuth 토큰 관리를 참조하세요.