앱용 GitHub OAuth 2.0 자격 증명 생성 - 용 JWT GitHub 애플리케이션 취약성 통합

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

    • 에 대한 GitHub 애플리케이션 취약성 통합JWT 전달자 토큰을 사용하여 앱을 통합 GitHub 하려면 다음 단계를 수행하십시오.

    필요한 역할:
    • sn_vul.app_sec_manager 및 관리자 ServiceNow AI Platform.
    • 계정의 GitHub 작업에 필요한 인스턴스 역할이 없습니다.
    • 이 설정 단계의 컨텍스트에 대한 자세한 내용은 OAuth 2.0 프로토콜을 참조하십시오.

    용 앱 생성 및 구성 GitHubGitHub 애플리케이션 취약성 통합

    계정에서 GitHub 사용자 지정 GitHub 앱을 생성하여 인스턴스에서 OAuth GitHub 애플리케이션 취약성 통합 2.0 인증을 활성화합니다.

    시작하기 전에

    필요한 역할: 인스턴스 역할 필요 없음

    이 태스크 정보

    계정에서 이 단계를 완료합니다 GitHub . 참조 건물 GitHub 앱 GitHub 개발자 사이트에서 사용자 지정 애플리케이션 생성 및 구성에 대한 지침을 확인할 수 있습니다.

    프로시저

    1. 계정에서 GitHub 다음으로 이동하여 앱을 생성합니다 GitHub . 개발자 설정 > GitHub 앱.
    2. 홈페이지 URL 필드에 https://<instance-name>.service-now.com 을 입력합니다.
    3. 사용자 인증 콜백 URL 필드에 https://<instance-name>.service-now.com/oauth_redirect.do 을 입력합니다.
    4. 사용자 식별 및 권한 부여 섹션에서 사용자 인증 토큰 만료 필드의 선택을 취소합니다.
    5. 웹후크 섹션에서 활성 필드를 선택합니다.
    6. 웹후크 URL 필드에 https://instance-name>.service-now.com/ 를 입력합니다.
    7. 나머지 필드는 비워 둡니다(기본값).
    8. 리 포지토리 권한 섹션에서 다음 설정을 구성합니다.
      코드 스캔 읽기 전용
      콘텐츠 읽기 전용
      사용자 지정 속성 읽기 전용
      Dependabot alerts 읽기 전용
      메타데이터 읽기 전용
      주:
      이미 GitHub App을(를) 사용 중이고 권한을 업데이트하는 경우 GitHub App에 대한 해당 권한을 검토하고 수락해야 합니다. 앱으로 이동하여 구성 > 검토 요청 > 새 권한 수락을 선택할 수 있습니다.
    9. 나머지 권한은 액세스 권한 없음 (기본값)으로 둡니다.
    10. 이벤트 구독 섹션에서 배포 보호 규칙 옵션을 선택합니다.
    11. 헤더를 마우스 오른쪽 버튼으로 클릭하여 변경 내용을 저장합니다.
    12. 선택한 계정에 새로 만든 GitHub 앱을 설치합니다.
      1. GitHub Apps 설정 페이지에서 앱을 선택합니다.
      2. 왼쪽 사이드바에서 앱 설치를 선택합니다.
      3. 올바른 리포지토리가 포함된 조직 또는 개인 계정 옆에 있는 설치를 선택합니다.
      4. 모든 리포지토리에 앱을 설치하거나 리포지토리를 선택합니다.
        자세한 내용은 GitHub Apps 설치를 참조하세요.
    13. 설치 후 앱의 설정(톱니바퀴 아이콘)을 선택하고 다음 정보를 기록하거나 기록해 두십시오.

      이러한 상세 정보는 인스턴스에 ServiceNow AI Platform 애플리케이션 레지스트리를 생성할 때 필요합니다.

      • 앱 ID
      • 클라이언트 ID
      • 클라이언트 비밀입니다.
      • URL에 있는 토큰을 기록해 둡니다. 인스턴스의 토큰 URL에 입력하는 토큰 ID입니다.
    14. 페이지를 아래로 스크롤하여 새 개인 키를 생성하고 컴퓨터에 저장합니다.

    GitHub 애플리케이션 취약성 통합에 대한 JKS 인증서 생성

    에 대한 GitHub 애플리케이션 취약성 통합JWT 인증을 위한 JKS 인증서를 생성합니다.

    시작하기 전에

    .jks 파일(KeyStore 암호)을 생성하는 데 사용하는 암호를 기록해 두어야 합니다.

    필요한 역할: sn_vul.app_sec_manager

    프로시저

    1. 앱 개인 키를 사용하여 GitHub CA 서명 인증서를 만듭니다. 
      openssl req -new -x509 -key <file-name>.pem -out <certificate-name>.pem -days 1095
    2. 필요한 상세 정보를 입력합니다.
    3. 앱 개인 키와 CA 서명 인증서를 사용하여 GitHub PKCS 12 파일을 만듭니다. 
      openssl pkcs12 -export -in <certificate-name>.pem -inkey <file-name>.pem -certfile <certificate-name>.pem -out <PKCS-12-file-name>.p12
    4. 익스포트 암호를 입력합니다.
    5. JKS 파일을 생성합니다. 
      keytool -importkeystore -srckeystore <PKCS-12-file-name>.p12 -srcstoretype pkcs12 -destkeystore <JKS-certificate-filename>.jks -deststoretype JKS
    6. 대상 및 소스 키 스토어 암호를 입력합니다.

    GitHub 애플리케이션 취약성 통합 의 인스턴스에 Java 키 스토어 인증서를 연결합니다 GitHub.

    유효한 GitHub JKS(Java KeyStore) 인증서를 인스턴스에 연결하여 JWT 전달자 부여 토큰 인증을 활성화합니다.

    시작하기 전에

    유효한 Java KeyStore 인증서입니다.

    필요한 역할: sn_vul.app_sec_manager

    프로시저

    1. 다음으로 이동 모두 > 시스템 정의 > 인증서.
    2. 새로 만들기를 선택합니다.
    3. 양식에서 필드를 채웁니다.
      표 1. X.509 인증서 양식 필드
      필드 설명
      이름 기록을 고유하게 식별하는 이름입니다. AVR에 대한 내 GitHub 앱 인증서를 예로 들 수 있습니다.
      만료 시 알림 인증서가 만료될 때 알림을 받을 사용자를 지정하는 옵션입니다.
      만료되기 전 경고 인증서가 만료되기 전에 알림을 보낼 일 수입니다.
      활성 인증서를 사용하도록 설정하는 옵션입니다.
      유형 인증서 유형을 선택하는 옵션입니다. Java 키 스토어를 선택합니다.
      며칠 후 만료 인증서가 만료될 때까지의 일 수입니다.
      키 스토어 암호 인증서와 관련된 암호입니다(힌트: 이전에 만든 대상 KeyStore 암호).
      간단한 설명 인증서에 대한 요약입니다.
    4. 첨부 파일 아이콘을 선택하고 JKS 인증서를 첨부합니다.
    5. 스토어/인증서 확인을 선택합니다.
      유효한 인증서 파일에 대해 유효한 key_store 메시지가 표시됩니다.

    GitHub 애플리케이션 취약성 통합 의 JKS 인증서에 GitHub대한 JWT 서명 키 생성

    Java KeyStore 인증서에 GitHub 할당할 JWT(JSON 웹 토큰) 서명 키를 만듭니다.

    시작하기 전에

    필요한 역할:
    • 관리자
    • sn_vul.app_sec_manager

    프로시저

    1. 다음으로 이동 모두 > 시스템 OAuth > JWT 키.
    2. 새로 만들기를 선택합니다.
    3. 양식에서 필드를 채웁니다.
      표 2. JWT 키 양식 필드
      필드 설명
      이름 JWT 서명 키를 고유하게 식별하는 이름입니다. 예를 들어 AVR에 대한 내 GitHub 앱 JWT 키입니다.
      서명 키 스토어 이전 작업에서 첨부한 유효한 JKS 인증서를 선택합니다.
      키 ID 이 필드는 비워 둡니다.
      서명 알고리즘 이 값은 RSA 256으로 둡니다.
      서명 키 암호 서명 키와 관련된 암호입니다. JKS 파일을 생성하는 데 사용한 암호입니다.
      활성 키를 활성화하는 옵션입니다.
    4. 페이지의 회색 헤더에서 아무 곳이나 마우스 오른쪽 버튼으로 클릭하고 저장을 선택합니다.

    GitHub 애플리케이션 취약성 통합 의 서명 키에 대한 GitHubJWT 제공자 만들기

    에 대한 GitHub인스턴스에 ServiceNow JSON 웹 토큰(JWT) 제공자를 추가합니다.

    시작하기 전에

    필요한 역할:
    • 관리자
    • sn_vul.app_sec_manager

    프로시저

    1. 다음으로 이동 모두 > 시스템 OAuth > JWT 제공자.
    2. 새로 만들기를 선택합니다.
    3. 양식에서 필드를 채웁니다.
      표 3. JWT 제공자 양식 필드
      필드 설명
      이름 JWT 제공자를 고유하게 식별할 수 있습니다. 예를 들어 AVR에 대한 내 GitHub 앱 JWT 공급자입니다.
      만료 간격(초) JWT 제공자 토큰의 수명을 설정하는 숫자(초)입니다. 이 설정을 기본값으로 유지할 수 있습니다.
      서명 구성 이전 단계에서 생성한 JWT 키를 선택합니다.
    4. 양식 헤더를 마우스 오른쪽 버튼으로 클릭하고 저장을 선택합니다.
    5. 표준 클레임 관련 목록에서 iss 클레임 값에 대한 앱 앱 ID를 입력합니다GitHub.
      이전 단계에서 만든 콘솔의 GitHub 앱에 GitHub 있는 앱 ID입니다.
    6. aud 및 sub 값은 비워 둡니다(기본값).
    7. 양식 헤더를 마우스 오른쪽 버튼으로 클릭하고 저장을 선택합니다.

    GitHubGitHub 애플리케이션 취약성 통합에 대한 OAuth 공급자(JWT)로 등록

    앱 계정 구성 중에 GitHub 생성된 정보를 사용하여 OAuth 공급자로 등록 GitHub 하고 인스턴스가 OAuth 2.0 토큰을 요청하도록 허용합니다.

    시작하기 전에

    필요한 역할:
    • 관리자
    • sn_vul.app_sec_manager

    프로시저

    1. 다음으로 이동 모두 > 시스템 OAuth > 애플리케이션 레지스트리.
    2. 새로 만들기를 선택합니다.
      어떤 종류의 OAuth 애플리케이션입니까? 메시지가 표시됩니다.
    3. 외부 공급업체 OAuth 제공자에 연결을 선택합니다.
    4. 양식에서 필드를 채웁니다.
      표 4. 애플리케이션 레지스트리 양식 필드
      필드 설명
      이름 기록을 고유하게 식별하는 이름입니다. 예를 들어 AVR용 My GitHub App Provider를 입력합니다.
      클라이언트 ID 앱의 클라이언트 ID입니다 GitHub . 클라이언트 ID는 이전 단계에서 만든 콘솔의 GitHub 애플리케이션에서 가져온 GitHub 것입니다. 이 ID는 에서 앱 구성의 GitHub정보 섹션에서 확인할 수 있습니다GitHub.
      접근 가능 이 설정을 현재 값으로 둡니다.
      클라이언트 비밀 앱의 GitHub 클라이언트 비밀입니다. 클라이언트 비밀은 이전 단계에서 만든 콘솔의 GitHub 애플리케이션에서 가져옵니다GitHub. 이 ID는 에서 앱 구성의 GitHub정보 섹션에서 확인할 수 있습니다GitHub.
      활성 키를 활성화하는 옵션입니다. 이 항목을 선택한 상태로 둡니다.
      인증 URL 이 URL은 자동으로 생성됩니다.
      토큰 URL 인스턴스가 토큰을 검색하고 새로 고치는 데 사용하는 토큰 엔드포인트의 위치입니다. 앱의 URL에서 토큰을 GitHub 입력합니다. 앱은 앱을 설치 GitHub한 후 URL에 표시되는 토큰입니다. 의 GitHub 앱 구성 GitHub에 있는 앱 설치 섹션에서 톱니바퀴를 선택합니다. 토큰이 웹 페이지 URL에 표시됩니다.
      OAuth API 스크립트 수정된 OAuthUtil 스크립트 포함을 참조할 수 있는 옵션입니다. OAuthGitHubJWTHandler를 선택합니다.
      기본 부여 유형 애플리케이션 레지스트리와 연결된 부여 유형입니다. JWT 전달자를 선택합니다.
    5. 나머지 양식 필드는 기본값으로 둡니다.
    6. 양식 헤더를 마우스 오른쪽 버튼으로 클릭하고 저장을 선택합니다.
    7. OAuth 엔터티 프로파일 관련 목록으로 스크롤하여 선택한 다음 목록에서 생성된 기본 프로파일을 엽니다.
    8. JWT 제공자 필드를 이전에 생성한 JWT 제공자로 채우고 양식을 저장합니다.
    9. 애플리케이션 레지스트리 파일로 돌아가서 저장합니다.
    10. 다음으로 이동 주요 운영 > 모듈 접근 정책 > 모두.
    11. com_snc_platform_security_oauth_glideencrypter가 암호화 모듈 필드 값으로 표시되고 OAuthGitHubJWTHandler가 대상 스크립트 필드의 스크립트 포함이 되도록 정책을 선택합니다.

      다음 이미지에서 com_snc_platform_security_oauth_glideencrypter 이 암호화 모듈 필드의 값으로 선택됩니다. 스크립트 테이블 필드에는 스크립트 포함 [sys_script_include] 테이블이 표시되며 대상 스크립트 필드 값은 OAuthGitHubJWTHandler입니다.

      스크립트 포함이 있는 암호화 모듈 필드 OAuthGitHubJWTHandler

    12. 업데이트를 선택합니다.

      유형: 스크립트 및 결과: 추적

      앞의 이미지와 같이 정책 이름 필드의 값이 변경되고 스크립트 테이블 및 대상 스크립트 필드가 더 이상 표시되지 않습니다.
    13. 결과 필드가 추적으로 설정되어 있는지 확인하고 변경 내용을 저장합니다.

    GitHub 애플리케이션 취약성 통합에 대한 자격 증명 및 연결 생성

    이전에 앱 제공자에게 GitHub 자격 증명 기록을 생성하여 작업을 승인합니다.

    시작하기 전에

    필요한 역할:
    • 관리자
    • sn_vul.app_sec_manager

    프로시저

    1. 다음으로 이동 자격 증명 및 연결 > 자격 증명.
    2. 새로 만들기를 선택합니다.
    3. OAuth 2.0 자격 증명을 선택합니다.
    4. 새로 만들기를 선택하고 필드에 내용을 입력합니다.
      필드설명
      이름 기록의 고유한 이름입니다.
      적용 대상 모든 MidServer 또는 특정 MidServer를 선택합니다.
      OAuth 엔터티 프로파일 검색 아이콘을 선택하고 이전 단계에서 생성한 엔터티 프로파일을 찾습니다.
      기타 필드 이 필드는 기본값으로 둡니다.
    5. 페이지 헤더의 아무 곳이나 마우스 오른쪽 버튼으로 클릭하고 저장을 선택합니다.
      자격 증명 목록이 표시됩니다.
    6. 방금 생성한 기록을 열고 OAuth 토큰 가져오기 관련 링크를 선택합니다.
      OAuth 토큰을 성공적으로 임포트했다는 메시지가 표시됩니다.
    7. 다음으로 이동 자격 증명 및 연결 > 연결 및 자격 증명 별칭.
    8. 새로 만들기를 선택하고 필드에 내용을 입력합니다.
      필드설명
      이름 기록의 이름입니다.
      애플리케이션 읽기 전용입니다.
      상위 별칭(선택 사항) 검색 아이콘을 선택하고 목록에서 하나를 선택합니다.
      유형 연결 및 자격 증명
      연결 유형 HTTP입니다.
      다중 활성 연결 지원(선택 사항) 비활성화되었습니다.
      기본 재시도 정책 기본 HTTP 재시도 정책
      구성 템플릿 비워 둡니다.
    9. 제출을 선택합니다.
      연결 및 자격 증명 별칭 목록이 표시됩니다.
    10. 기록을 열고 연결 관련 목록 탭에서 새로 만들기 를 선택한 다음 HTTP 연결 기록의 필드에 내용을 입력합니다.
      필드설명
      이름 기록의 이름입니다.
      활성 활성화되었습니다.
      자격 증명 이전 단계에서 생성한 자격 증명 레코드를 선택합니다.
      연결 별칭 기록이 표시됩니다.
      URL 작성기 비활성화되었습니다.
      연결 URL

      엔터프라이즈용 https://api.github.com 기본 URL입니다. 온 프레미스는 GitHub 엔드포인트 URL입니다.
      MID 서버 사용(선택 사항) 온프레미스에는 MID 서버가 필요합니다. 엔터프라이즈의 경우 선택 사항입니다.
      연결 시간 제한 값을 입력합니다.
    11. 제출을 선택합니다.
      연결 및 자격 증명 별칭 목록이 표시됩니다. 이제 다음 단계를 완료할 준비가 되었습니다.GitHub 애플리케이션 취약성 통합 구성 연결 필드에 이전 단계에서 생성한 자격 증명을 입력합니다.