기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Atlassian Confluence Cloud 지식 기반 통합
<a name="confluence-knowledge-base"></a>

Amazon Quick 에이전트가 이에 대한 질문을 검색하고 답변할 수 있도록 Atlassian Confluence Cloud 지식 기반 통합을 사용하여 Confluence 콘텐츠를 인덱싱합니다. Amazon Quick은 Confluence 지식 기반에 대한 선택적 문서 수준 액세스 제어(ACLs)를 지원합니다. 활성화하면 사용자는 Confluence에서 액세스할 수 있는 권한이 부여된 문서의 답변만 볼 수 있습니다. 자세한 내용은 [문서 수준 액세스 제어](confluence-kb-acl.md) 단원을 참조하십시오.

## 시작하기 전 준비 사항
<a name="confluence-kb-prerequisites"></a>

통합을 설정하기 전에 다음 사항이 있는지 확인합니다.
+ Atlassian Confluence 클라우드 인스턴스입니다.
+ 빠른 구독 요구 사항은 섹션을 참조하세요[콘솔에서 통합 설정](integration-console-setup-process.md).

문서 수준 액세스 제어를 활성화하려는 경우 설정 중에 Atlassian 관리자 자격 증명을 제공해야 합니다. 이러한 자격 증명을 통해 Amazon Quick은 개별 이메일 가시성 설정에 관계없이 모든 사용자 및 그룹 정보에 액세스할 수 있습니다. 관리자 자격 증명이 없으면 지식 기반 생성 중에 ACL 옵션을 사용할 수 없습니다. 관리자 자격 증명을 제공하려면 Atlassian 조직 관리자의 다음이 필요합니다.
+ **Atlassian 관리자 API 키** - Atlassian 관리자 포털에서 생성된 영숫자 문자열입니다.
+ **조직 ID(UUID)** - Atlassian 조직의 고유 식별자입니다. 관리자 포털에 로그인할 때 브라우저 URL에서 이를 찾을 수 있습니다`admin.atlassian.com/o/orgId`.
+ **디렉터리 ID(UUID)** - 사용자 디렉터리의 고유 식별자입니다. Atlassian Admin Workspace API를 사용하여이 값을 검색합니다.

이러한 자격 증명을 얻는 자세한 단계는 섹션을 참조하세요[Atlassian 관리자 자격 증명 가져오기](confluence-kb-acl.md#confluence-kb-atlassian-admin-credentials).

## 지식 기반 통합 설정
<a name="confluence-kb-setup"></a>

설정 마법사에는 인증, 지식 기반 생성 및 추가 설정의 세 단계가 있습니다.

### 계정 인증
<a name="confluence-kb-setup-auth"></a>

1. Amazon Quick 콘솔에서 **통합을** 선택합니다.

1. **지식**에서 **Atlassian Confluence Cloud**를 선택하고 추가(더하기 "\$1") 버튼을 선택합니다.

1. **Confluence 지식 기반 생성** 대화 상자의 **인증 방법**에서 **이름** 드롭다운에서 기존 연결 계정을 선택하거나 **계정 추가**를 선택하여 새 연결을 생성합니다.

1. 새 계정을 추가하는 경우 다음 필드를 작성합니다.
   + **이름** - 연결을 설명하는 이름입니다.
   + **설명**(선택 사항) - 연결에 대한 참고 사항입니다.
   + **Confluence URL** - Atlassian 사이트의 URL입니다(예: `https://your-site.atlassian.net`).

1. (선택 사항) **ACL 관리**에서 **Atlassian 관리자 자격 증명 사용을** 선택하여 Atlassian 관리자 자격 증명을 제공합니다. 선택하면 다음을 입력합니다.
   + **API 키** - Atlassian 관리자 API 키입니다.
   + **OrganizationID(UUID)** - Atlassian 조직 ID입니다.
   + **디렉터리 ID(UUID)** - Atlassian 사용자 디렉터리 ID입니다.
**중요**  
**추가 설정**에서 문서 수준 액세스 제어(ACLs)를 활성화하려면 Atlassian 관리자 자격 증명이 필요합니다. 관리자 자격 증명이 없으면 ACL 옵션이 비활성화됩니다. 지식 기반을 생성한 후에는 관리자 자격 증명을 추가할 수 없습니다. 이러한 자격 증명을 얻는 단계는 섹션을 참조하세요[Atlassian 관리자 자격 증명 가져오기](confluence-kb-acl.md#confluence-kb-atlassian-admin-credentials).

1. **다음**을 선택합니다.

1. 표시되는 Confluence 클라우드 인증 팝업을 완료합니다. 요청된 권한을 검토하고 **수락**을 선택하여 Amazon Quick이 Confluence 콘텐츠에 액세스할 수 있는 권한을 부여합니다.

### 지식 기반 생성
<a name="confluence-kb-setup-create"></a>

1. **지식 기반 생성**에서 지식 기반 **이름을** 입력합니다.

1. (선택 사항) 지식 기반 사용 방법에 대한 메모와 함께 **설명을** 입력합니다.

1. **Confluence URLs**에서 포함하려는 Confluence 스페이스, 블로그 또는 페이지의 URLs을 붙여넣습니다. 각 URL 뒤에 **추가**를 선택합니다.
**참고**  
구조를 따르는 URLs`https://company.atlassian.net/wiki/spaces/space-key/overview`은 스페이스 URLs 아닌 페이지 URLs로 처리됩니다. 전체 스페이스를 인덱싱하려면를 사용하지 않고 스페이스 URL을 사용합니다`/overview`(예: `https://company.atlassian.net/wiki/spaces/space-key`).

1. **다음: 추가 설정을** 선택하여 액세스 제어 및 인덱싱 옵션을 구성하거나 **생성을** 선택하여 기본 설정으로 지식 기반을 생성합니다.

### 추가 설정 구성
<a name="confluence-kb-setup-settings"></a>

1. 문서 수준 액세스 제어를 활성화하려면 ** ACLs 사용하여 문서 액세스 제어를** 선택합니다. 이 옵션은 **인증 방법**에서 Atlassian 관리자 자격 증명을 제공한 경우에만 사용할 수 있습니다. 활성화되면 Amazon Quick은 Confluence의 액세스 제어 목록을 동기화하고 쿼리 시 각 사용자의 권한을 확인합니다. 액세스 제어의 작동 방식에 대한 자세한 내용은 섹션을 참조하세요[문서 수준 액세스 제어](confluence-kb-acl.md).

   ACLs 활성화하지 않으면 지식 기반 수준에서 액세스가 제어됩니다. 지식 기반에 액세스할 수 있는 사람은 누구나 지식 기반 내의 모든 콘텐츠에서 인사이트를 얻을 수 있습니다. ACLs 활성화되면 문서 수준에서 액세스가 제어됩니다. 지식 기반에 액세스할 수 있는 사용자는 Confluence에서 액세스할 수 있는 권한이 있는 문서의 답변만 볼 수 있습니다.
**중요**  
지식 기반이 생성된 후에는 ACL 관리를 변경할 수 없습니다. 이 설정을 변경해야 하는 경우 새 지식 기반을 생성해야 합니다.
**참고**  
**인증 방법**에서 Atlassian 관리자 자격 증명을 제공하지 않은 경우이 옵션은 비활성화됩니다. ACLs 활성화하려면 마법사 **뒤로** 또는 취소를 선택하고 관리자 자격 증명이 포함된 연결된 계정으로 다시 시작합니다.

1. **멀티미디어 콘텐츠, 파일 크기 및 파일 패턴**에서 필요에 따라 다음 인덱싱 옵션을 구성합니다.
   + **문서의 시각적 콘텐츠** - 문서에 포함된 이미지 및 차트와 같은 시각적 콘텐츠를 인덱싱합니다.
   + **오디오 파일** - 오디오 파일 첨부 파일을 인덱싱합니다.
   + **비디오 파일** - 비디오 파일 첨부 파일을 인덱싱합니다.
   + **최대 단일 파일 크기** - 개별 첨부 파일의 최대 파일 크기입니다(기본값: 50MB).

1. **생성(Create)**을 선택합니다.

## 지원되는 콘텐츠 유형
<a name="confluence-kb-content-types"></a>
+ Confluence 페이지 및 블로그 게시물
+ 페이지 및 블로그 게시물 첨부 파일

Confluence 스페이스 URL을 추가하면 Amazon Quick은 해당 스페이스 내의 모든 페이지와 블로그 게시물을 크롤링합니다. 지원되는 첨부 파일 유형 및 크기 제한은 섹션을 참조하세요[파일 크기 및 콘텐츠 제한](knowledge-base-integrations.md#file-size-and-content-limits).

## 지식 기반 관리
<a name="confluence-kb-management"></a>

### 기존 지식 기반 편집
<a name="confluence-kb-edit"></a>

1. Amazon Quick 콘솔에서 **지식 기반을** 선택합니다.

1. 목록에서 Confluence 클라우드 지식 기반을 선택합니다.

1. **작업**에서 점 3개 아이콘을 선택한 다음 **지식 기반 편집**을 선택합니다.

1. 필요에 따라 구성 설정을 업데이트하고 **저장**을 선택합니다.

## 문제 해결
<a name="confluence-kb-troubleshooting"></a>

통합을 편집, 공유 또는 삭제하려면 섹션을 참조하세요[기존 통합 관리](integration-workflows.md#managing-existing-integrations).

동기화 문제 및 누락된 문서를 포함한 일반적인 지식 기반 문제 해결은 섹션을 참조하세요[지식 기반 문제 해결](troubleshooting-knowledge-bases.md).

### 차단된 OAuth 앱 권한 부여
<a name="confluence-kb-troubleshooting-blocked-oauth"></a>

**증상:**
+ 오류 메시지: “앱이 계정에 액세스하려면 사이트 관리자가 사이트 *instance-name*.atlassian.net 대해이 앱을 승인해야 합니다.”
+ 동의 대화 상자에서 **수락**을 선택하면 효과가 없습니다.

**원인:**

Atlassian 사이트 관리자가 사용자 설치 OAuth 앱을 차단했습니다. 이 설정이 활성화되면 사이트 또는 조직 관리자만 새 타사 앱을 승인할 수 있습니다.

**해결 단계:**

다음 옵션 중 하나를 사용하여이 문제를 해결합니다.
+ **옵션 1(권장): 관리자가 앱을 직접 승인합니다.**

  1. Atlassian 사이트 관리자가 Amazon Quick으로 이동하여 Confluence Cloud로 새 지식 기반 설정을 시작합니다.

  1. 관리자에게 사이트 수준 권한이 있으므로 오류 없이 명확한 동의 화면이 나타납니다.

  1. 관리자는 **수락**을 선택하여 앱을 설치합니다.

  관리자가 앱을 승인하면 사이트의 다른 모든 사용자가 문제 없이 연결할 수 있습니다.
+ **옵션 2: 사용자 설치 앱 임시 허용 -** 관리자가 로 이동하여 **앱**, **Atlassian 앱**으로 `admin.atlassian.com`이동한 다음 타사 및 Marketplace 앱의 링크를 선택합니다. **설정**에서 **사용자 설치 앱을 찾아 사용자 앱을 허용하도록 전환합니다**. 사용자가 Amazon Quick에 권한을 부여한 후 설정을 다시 전환하여 사용자 앱을 차단합니다.

**중요**  
관리자 권한 부여는 조직이 아닌 Atlassian 사이트별로 적용됩니다. 회사에 여러 사이트(예: `team-a.atlassian.net` 및 `team-b.atlassian.net`)가 있는 경우 각 사이트에 별도의 권한이 필요합니다.

**참고**  
사용자 설치 앱이 차단 해제되어 있는 동안(옵션 2), 사이트의 모든 사용자는 모든 OAuth 앱을 승인할 수 있습니다. 사용자가 연결한 후 즉시 블록을 다시 활성화합니다.

### 인증 팝업 실패
<a name="confluence-kb-troubleshooting-auth-popup"></a>

**증상:**
+ 인증 팝업이 표시되지 않거나 즉시 닫힙니다.
+ 팝업이 표시되지만 OAuth 흐름을 완료하지 못합니다.

**해결 단계:**

1. 브라우저가 Amazon Quick 콘솔 도메인의 팝업을 허용하는지 확인합니다.

1. 네트워크에서 Confluence 클라우드 인스턴스에 액세스할 수 있는지 확인합니다.

1. 다른 브라우저를 사용하거나 브라우저 캐시를 지우십시오.

### 지식 기반에 누락된 콘텐츠
<a name="confluence-kb-troubleshooting-missing-content"></a>

**증상:**
+ 지식 기반 동기화는 완료되지만 예상 콘텐츠는 인덱싱되지 않습니다.
+ 검색 결과에는 특정 공백 또는 페이지의 콘텐츠가 포함되지 않습니다.
+ 전체 스페이스에 대해 하나의 문서만 인덱싱됩니다.

**해결 단계:**

1. 인증한 Confluence 클라우드 사용자가 설정 중에 선택한 스페이스와 페이지에 액세스할 수 있는지 확인합니다.

1. 선택한 콘텐츠 유형(페이지, 블로그 게시물 및 첨부 파일)이 지원되는지 확인합니다.

1. 지식 기반 구성의 콘텐츠 선택을 검토하여 올바른 공백과 페이지가 포함되어 있는지 확인합니다.

1. Confluence URLs `/overview` 접미사를 확인합니다. 로 끝나는 URLs`/wiki/spaces/space-key/overview`은 전체 스페이스가 아닌 단일 페이지 URL로 처리됩니다. 전체 스페이스를 인덱싱하려는 경우를 사용하지 않고 스페이스 URL을 사용합니다`/overview`(예: `https://company.atlassian.net/wiki/spaces/space-key`).

### ACL 관련 문제
<a name="confluence-kb-troubleshooting-acl"></a>

**ACL 지원 지식 기반의 결과 없음**
+ 첫 번째 쿼리 중에 메시지가 표시되면 최종 사용자가 Confluence에 로그인했는지 확인합니다. 실시간 권한 확인을 위해서는 로그인이 필요합니다.
+ 최종 사용자가 Confluence 인스턴스의 관련 Confluence 콘텐츠에 액세스할 수 있는지 확인합니다.

**동기화 중에 건너뛴 문서**
+ 동기화 보고서에 SKIPPED 상태의 항목이 표시되면 인증 사용자가 지식 기반에 포함된 Confluence 스페이스 및 페이지에 액세스할 수 있는지 확인합니다.
+ 문서 액세스 확인에 대한 자세한 내용은 섹션을 참조하세요[문서 액세스 확인(ACL 확인)](sync-reports-observability.md#sync-reports-acl-verification).