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

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

Amazon Quick 에이전트가 이에 대한 질문을 검색하고 답변할 수 있도록 Atlassian Confluence Cloud 지식 기반 통합을 사용하여 Confluence 콘텐츠를 인덱싱합니다.

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

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

## Authentication
<a name="confluence-kb-auth-setup"></a>

지식 기반 통합의 경우 Amazon Quick은 설정 중에 팝업 흐름을 통해 인증을 처리합니다. 다음 단계를 완료합니다.

1. 표시되는 Confluence 클라우드 인증 팝업을 완료합니다.

1. Amazon Quick이 Confluence 콘텐츠에 액세스할 수 있는 권한을 부여합니다.

1. 인증 프로세스를 검토하고 완료합니다.

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

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

1. **Atlassian Confluence Cloud**를 선택하고 추가(‘\$1’ 추가) 버튼을 선택합니다.

1. **Confluence 지식 기반 생성** 대화 상자의 **연결된 계정**에서 다음 필드를 작성합니다.
   + **이름** - 데이터 액세스 통합을 설명하는 이름입니다.
   + **Confluence URL** - Atlassian 사이트의 URL입니다(예: `your-site.atlassian.net`).

1. **로그인**을 선택하고 팝업 창에서 Confluence 클라우드 인증 흐름을 완료합니다.

1. **지식 기반 생성**에서 다음 필드를 작성합니다.
   + **이름** - 지식 기반의 이름입니다.
   + **설명**(선택 사항) - 지식 기반 사용 방법에 대한 참고 사항입니다.

1. **콘텐츠**에서 포함하려는 Confluence 스페이스, 블로그 또는 페이지의 URLs을 붙여넣습니다. 각 URL 뒤에 **추가**를 선택합니다.
**참고**  
구조를 따르는 URLs`https://company.atlassian.net/wiki/spaces/space-key/overview`은 페이지 URLs로 처리됩니다.

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

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

## 액세스 제어
<a name="confluence-kb-access-controls"></a>

**중요**  
Amazon Quick은 데이터 소스의 액세스 제어 목록(ACLs 동기화하지 않습니다. Amazon Quick에서 지식 기반을 생성할 때 기본적으로 지식 기반에서 인사이트만 얻을 수 있습니다. 공유 콘텐츠의 경우 지식 기반 권한을 업데이트하여 다양한 사용자 및 그룹에 대한 액세스를 제공할 수 있습니다.

## 지식 기반 관리
<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`).