외부 콘텐츠 인덱싱을 위한 클라우드 구성 GitHub Enterprise

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

    • 클라우드 외부 콘텐츠 커넥터가 GitHub Enterprise 클라우드 콘텐츠에 GitHub Enterprise 액세스할 수 있도록 앱을 만들고 권한을 부여 GitHub 합니다.

    시작하기 전에

    다음 항목이 모두 필요합니다.

    필요한 역할: 없음

    이 태스크 정보

    클라우드 외부 콘텐츠 커넥터는 GitHub Enterprise REST API를 사용하여 클라우드 소스 시스템의 공개 및 내부 리포지토리에 GitHub Enterprise 있는 커밋, 문제 및 끌어오기 요청에서 검색 가능한 콘텐츠와 메타데이터를 검색합니다 GitHub .

    커넥터가 REST API를 통해 클라우드 소스 시스템에 액세스할 GitHub Enterprise 수 있도록 허용하려면 클라우드에서 GitHub Enterprise 조직에 대한 앱을 구성하고 권한을 부여 GitHub 해야 합니다. 커넥터 관리자는 앱에서 복사한 GitHub 설정을 사용하여 소스 시스템에 적절하게 연결하도록 클라우드 외부 커넥터를 구성할 GitHub Enterprise 수 있습니다.

    프로시저

    1. 클라우드 외부 콘텐츠 커넥터용 GitHub Enterprise 새 GitHub 앱을 생성합니다.
      1. 클라우드 자격 증명으로 이동 https://github.com/ 하고 GitHub Enterprise 로그인합니다.
      2. 프로필 그림을 선택한 다음 컨텍스트 메뉴에서 내 기업 을 선택합니다.
        Enterprise Managed Users를 사용하지 않는 경우 내 엔터프라이즈를 선택한 다음, 설정을 선택합니다.
      3. 메뉴에서 설정 > 개발자 설정 > GitHub 앱.
      4. 새 GitHub 앱을 선택합니다.
      5. 새 GitHub 앱 등록 페이지에서 새 GitHub 앱의 이름을 입력합니다.
        예를 들어 외부 콘텐츠 커넥터를 입력할 수 있습니다.
        주:
        앱 이름은 길이가 34자를 초과할 수 없습니다.
      6. 홈페이지 URL 필드에 조직 GitHub 계정의 URL을 입력합니다.
        예를 들어 https://github.com/example 입력할 수 있습니다.
      7. 웹후크 섹션에서 활성 옵션의 선택을 취소합니다.
      8. 사용 권한 섹션에서 리포지토리 권한 목록을 확장하고 이러한 각 권한에 대해 읽기 전용 액세스를 선택합니다.
        • 커밋 상태
        • 콘텐츠
        • 토론
        • 문제
        • 큐 병합
        • 끌어오기 요청
      9. 권한 섹션에서 조직 권한 목록을 확장하고 구성원 권한에 대해 읽기 전용 액세스를 선택합니다.
      10. 이 GitHub 앱을 설치할 수 있는 위치 필드에서 이 계정에서만 옵션을 선택합니다.
      11. 앱 만들기GitHub를 선택합니다.
      새 GitHub 앱이 성공적으로 등록되었음을 나타내는 메시지가 표시되고 일반 설정 페이지로 이동합니다.
    2. 일반 설정 페이지에서 새 GitHub 앱의 클라이언트 ID 및 개인 키를 가져옵니다.
      1. 정보 섹션에서 새 GitHub 앱의 클라이언트 ID를 복사하여 안전한 위치에 저장합니다.
        중요사항:
        클라우드 외부 콘텐츠 커넥터를 구성할 때 외부 콘텐츠 커넥터 관리자에게 이 클라이언트 ID가 GitHub Enterprise 필요합니다.
      2. 개인 키 섹션에서 개인 키 생성을 선택합니다.
      3. 메시지가 표시되면 PEM 형식의 개인 키 인증서 파일을 안전한 위치에 다운로드합니다.
        중요사항:
        외부 콘텐츠 커넥터 관리자는 클라우드 외부 콘텐츠 커넥터를 구성할 때 이 PEM 형식의 GitHub Enterprise 개인 키 인증서 파일이 필요합니다.
    3. 새 GitHub 앱을 설치합니다.
      1. 새 GitHub 앱의 메뉴에서 앱 설치를 선택합니다.
      2. 조직 계정 항목 GitHub 에서 설치를 선택합니다.
      3. 새 GitHub 앱의 설치 페이지에서 외부 콘텐츠 커넥터가 액세스할 수 있도록 할 리포지토리를 선택합니다.
        • 외부 콘텐츠 커넥터에 조직이 소유한 모든 리포지토리에 대한 액세스 권한을 부여하려면 모든 리포지토리를 선택합니다.
        • 외부 콘텐츠 커넥터에 조직이 소유한 지정된 리포지토리 집합에 대한 액세스 권한을 부여하려면 리 포지토리만 선택을 선택한 다음 리포지토리 선택 드롭다운 목록을 사용하여 커넥터에 액세스 권한을 부여할 리포지토리를 찾아 선택합니다.
      4. 설치를 선택합니다.
    4. 새 GitHub 앱의 앱 설치 ID를 가져옵니다.
      1. 조직 페이지의 GitHub URL에서 조직의 식별자를 GitHub 가져옵니다.
        조직의 식별자는 조직 페이지의 GitHub URL에서 세 번째 슬래시 뒤의 URL 요소입니다. 예를 들어 조직 페이지의 GitHub URL이 https://github.com/example 면 조직의 식별자가 예와 같습니다.
      2. 새 GitHub 앱에 대한 JSON 웹 토큰(JWT)을 생성합니다.
        Ruby, Python, bash 또는 PowerShell을 사용하여 앱에 대한 GitHub JWT를 생성하는 방법에 대한 자세한 내용은 설명서 자원을 https://docs.github.com/en/enterprise-cloud@latest/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-json-web-token-jwt-for-a-github-app GitHub 참조하십시오.

        JWT를 생성하려면 단계에서 2.a 복사한 클라이언트 ID와 단계에서 다운로드한 PEM 형식 클라이언트 비밀 인증서 파일이 필요합니다.2.c

        중요사항:
        JWT는 생성 후 10분 후에 만료됩니다. 다음 단계를 수행하기 전에 만료되면 이 단계를 반복하여 새 JWT를 생성합니다.
      3. 다음 curl 명령을 실행하여 <org> 를 조직의 GitHub 식별자로 바꾸고 <json-web-token> 을 생성한 JWT로 바꿉니다. 
        curl --request GET \
  --url "https://api.github.com/orgs/<org>/installation" \
  --header "Accept: application/vnd.github+json" \
  --header "Authorization: Bearer <json-web-token>" \
  --header "X-GitHub-Api-Version: 2022-11-28"
      4. JSON 응답 객체에서 애플리케이션 설치의 ID 키-값 쌍을 찾아 해당 값을 복사한 다음 안전한 위치에 저장합니다.
        중요사항:
        클라우드 외부 콘텐츠 커넥터를 구성할 때 외부 콘텐츠 커넥터 관리자에게 이 앱 설치 ID가 GitHub Enterprise 필요합니다.

    다음에 수행할 작업

    커넥터 관리자에게 다음 항목을 제공합니다.
    • 단계에서 복사한 2.a클라이언트 ID입니다.
    • 단계에서 다운로드한 2.cPEM 형식의 개인 키 인증서 파일입니다.
    • 단계에서 복사한 앱 설치 ID입니다.4.d

    커넥터 관리자는 클라우드 소스 시스템에서 항목과 보안 주체를 검색하도록 클라우드 외부 콘텐츠 커넥터를 GitHub Enterprise 구성하려면 이러한 항목이 GitHub Enterprise 필요합니다.

    클라우드 외부 콘텐츠 커넥터 생성 및 구성에 GitHub Enterprise 대한 자세한 내용은 문서를 참조하십시오 클라우드 외부 콘텐츠 커넥터 생성 GitHub Enterprise.