보강 작업을 위한 외부 커넥터 구성

서드 파티 인증 제공업체를 사용하면 Knowledge Studio 보강 작업을 GitHub, Microsoft SharePoint, Atlassian Confluence와 같은 외부 플랫폼에 안전하게 연결할 수 있습니다. 기본 요건 설정의 일부로 이 문서의 사용자 인증 정보 생성 및 인증 제공업체 구성 단계를 완료합니다.

시작하기 전에

외부 커넥터를 구성하기 전에 다음 기본 요건을 완료했는지 확인합니다.

  • 보강 태스크의 기본 요건 구성에서 전체 보강 구성 워크플로를 검토합니다.
  • 대상 서드 파티 플랫폼 (GitHub, Microsoft SharePoint 또는 Atlassian Confluence)에서 액세스 토큰을 생성하거나 애플리케이션을 등록하는 데 필요한 관리자 또는 개발자 권한이 있는지 확인합니다.
  • 사용자 인증 정보를 안전하게 저장하고 작업에 연결하려면 에이전트 ID 서비스를 올바르게 구성해야 합니다. 자세한 내용은 인증 제공업체에 대한 IAM 권한 설정을 참조하세요.

보강 에이전트를 서드 파티 지식 소스에 연결할 때는 Google Cloud 에이전트 ID 서비스를 사용해야 합니다. 에이전트 ID는 서드 파티 사용자 인증 정보를 안전하게 저장하고 보강 에이전트에 단기 액세스 토큰을 프로비저닝하는 인증 관리자 역할을 하므로 작업 실행 중에 사람이 직접 원시 클라이언트 보안 비밀번호를 관리할 필요가 없습니다.

GitHub 구성

Knowledge Studio를 GitHub 저장소에 연결하려면 GitHub에서 세분화된 개인 액세스 토큰 (PAT)을 만들고 API 키 인증 제공업체에 저장해야 합니다.

  1. GitHub에 로그인하고 프로필 사진을 클릭한 후 설정을 클릭합니다.
  2. 개발자 설정 > 개인 액세스 토큰 > 세분화된 토큰으로 이동합니다.
  3. 새 토큰 생성을 클릭합니다.
  4. 토큰 속성을 구성합니다.
    • 토큰 이름: 설명이 포함된 이름 (예: enrichment-agent)을 입력합니다.
    • 만료: 적절한 만료일을 설정합니다.
    • 리소스 소유자: 대상 저장소를 소유한 조직 또는 사용자 계정을 선택합니다.
    • 저장소 액세스: 저장소만 선택을 선택하고 보강할 저장소를 선택합니다.
    • 권한: 필요한 범위 (예: 문제, pull 요청, 콘텐츠)에 대해 특정 읽기 또는 읽기 및 쓰기 액세스 권한을 부여합니다.
  5. 토큰 생성을 클릭하고 토큰을 안전하게 복사합니다.
  6. Google Cloud 에 API 키 인증 제공업체를 등록하고 PAT를 API 키로 제공합니다. 인증 관리자와 함께 API 키를 사용하여 인증을 참조하세요.

PAT를 만드는 방법에 대한 자세한 내용은 GitHub 문서의 개인 액세스 토큰 관리를 참조하세요.

Microsoft SharePoint 구성

Microsoft SharePoint에 연결하는 경우 2-Legged OAuth 흐름을 사용하여 Microsoft Entra ID (이전의 Azure Active Directory)에서 OAuth 사용자 인증 정보를 가져옵니다.

  1. Microsoft Entra 관리 센터에 새 애플리케이션을 등록합니다.
  2. Microsoft Graph API 권한을 부여합니다.
    1. API 권한 > 권한 추가 > Microsoft Graph > 애플리케이션 권한으로 이동합니다 (위임된 권한을 선택하지 마세요).
    2. Sites.Read.All 및 Files.Read.All 범위를 추가합니다.
    3. 테넌트에 대해 관리자 동의 부여를 클릭하여 두 애플리케이션 권한이 모두 '부여됨'으로 표시되도록 합니다.

  3. 새 클라이언트 보안 비밀번호를 만듭니다. 값은 한 번만 표시되므로 즉시 기록합니다. 자세한 내용은 새 클라이언트 보안 비밀번호 만들기를 참조하세요.

  4. 애플리케이션 구성 값을 복사합니다. 등록 후 인증 제공업체 구성에 대해 다음 값을 수집합니다.

    • 클라이언트 ID: 앱 개요의 애플리케이션 (클라이언트) ID입니다.
    • 토큰 URL: 개요 페이지에서 엔드포인트 탭을 클릭합니다. OAuth 2.0 토큰 엔드포인트 (v2)라는 라벨이 지정된 URL을 복사합니다.

  5. 이러한 보안 비밀을 사용하여 Google Cloud 에 2-legged OAuth 인증 제공업체를 등록합니다. 제공업체를 만들 때 --allowed-scopes 매개변수에 기본 범위를 제공합니다.

    --allowed-scopes="https://graph.microsoft.com/.default"

    자세한 내용은 Microsoft Entra 문서의 Microsoft ID 플랫폼에 애플리케이션 등록을 참조하세요.

Atlassian Confluence 구성하기

Confluence는 서버 간 에이전트에 대해 2-Legged OAuth를 지원하지 않으므로 Atlassian에서 전용 서비스 계정 (또는 더미 사용자 계정)을 만들고 필요한 권한을 부여하고 PAT를 생성해야 합니다.

  1. Confluence에서 특정 서비스 계정에 로그인합니다.
  2. 화면 오른쪽 상단의 프로필 사진을 클릭합니다.
  3. 메뉴에서 설정 (또는 계정 설정)을 선택합니다.
  4. 보안 탭에서 API 토큰 섹션으로 이동합니다.
  5. 범위가 있는 API 토큰 만들기 버튼을 클릭합니다. 범위가 지정되지 않은 토큰은 필요한 모든 도구를 가져오지 않으므로 사용하지 마세요.
  6. 설명이 포함된 이름 (예: enrichment-agent)을 입력하고 만료일을 구성한 후 다음을 클릭합니다.
  7. 앱 선택 목록에서 Atlassian MCP 옵션을 선택하고 다음을 클릭합니다.
  8. 다음 Confluence 읽기 및 검색 범위를 모두 선택합니다.
    • read:page:confluence
    • read:space:confluence
    • search:confluence
    • read:confluence-content.all
    • read:confluence-content.summary
    • read:confluence-space.summary
    • search:rovo:mcp
    • read:jira-work
  9. 다음을 클릭한 후 만들기를 클릭합니다.
  10. 생성된 토큰을 복사합니다.
  11. Google Cloud 인증 제공업체의 사용자 인증 정보 문자열을 <ATLASSIAN_EMAIL>:<API_TOKEN>로 지정합니다. Atlassian에서는 개인 API 토큰을 프로그래매틱 방식으로 사용하기 위해 HTTP 기본 인증 인코딩 (email:api_token)이 필요합니다.
  12. Google Cloud 에 API 키 인증 제공업체를 등록하고 <ATLASSIAN_EMAIL>:<API_TOKEN> 문자열을 API 키로 제공합니다. 인증 관리자와 함께 API 키를 사용하여 인증을 참조하세요.

PAT 만들기에 대한 자세한 내용은 Atlassian 문서의 Atlassian 계정의 API 토큰 관리를 참조하세요.

다음 단계