View a markdown version of this page

Atlassian Confluence Cloud 지식 기반 통합 - Amazon Quick
시작하기 전 준비 사항지식 기반 통합 설정지원되는 콘텐츠 유형지식 기반 관리문제 해결

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

Atlassian Confluence Cloud 지식 기반 통합

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

시작하기 전 준비 사항

통합을 설정하기 전에 다음 사항이 있는지 확인합니다.

  • Atlassian Confluence 클라우드 인스턴스입니다.

  • 빠른 구독 요구 사항은 섹션을 참조하세요콘솔에서 통합 설정.

문서 수준 액세스 제어를 활성화하려는 경우 설정 중에 Atlassian 관리자 자격 증명을 제공해야 합니다. 이러한 자격 증명을 통해 Amazon Quick은 개별 이메일 가시성 설정에 관계없이 모든 사용자 및 그룹 정보에 액세스할 수 있습니다. 관리자 자격 증명이 없으면 지식 기반 생성 중에 ACL 옵션을 사용할 수 없습니다. 관리자 자격 증명을 제공하려면 Atlassian 조직 관리자의 다음이 필요합니다.

  • Atlassian 관리자 API 키 - Atlassian 관리자 포털에서 생성된 영숫자 문자열입니다.

  • 조직 ID(UUID) - Atlassian 조직의 고유 식별자입니다. 관리자 포털에 로그인할 때 브라우저 URL에서 이를 찾을 수 있습니다admin.atlassian.com/o/orgId.

  • 디렉터리 ID(UUID) - 사용자 디렉터리의 고유 식별자입니다. Atlassian Admin Workspace API를 사용하여이 값을 검색합니다.

이러한 자격 증명을 얻는 자세한 단계는 섹션을 참조하세요Atlassian 관리자 자격 증명 가져오기.

지식 기반 통합 설정

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

계정 인증

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

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

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

  4. 새 계정을 추가하는 경우 다음 필드를 작성합니다.

    • 이름 - 연결을 설명하는 이름입니다.

    • 설명(선택 사항) - 연결에 대한 참고 사항입니다.

    • Confluence URL - Atlassian 사이트의 URL입니다(예: https://your-site.atlassian.net).

  5. (선택 사항) ACL 관리에서 Atlassian 관리자 자격 증명 사용을 선택하여 Atlassian 관리자 자격 증명을 제공합니다. 선택하면 다음을 입력합니다.

    • API 키 - Atlassian 관리자 API 키입니다.

    • OrganizationID(UUID) - Atlassian 조직 ID입니다.

    • 디렉터리 ID(UUID) - Atlassian 사용자 디렉터리 ID입니다.

    중요

    추가 설정에서 문서 수준 액세스 제어(ACLs)를 활성화하려면 Atlassian 관리자 자격 증명이 필요합니다. 관리자 자격 증명이 없으면 ACL 옵션이 비활성화됩니다. 지식 기반을 생성한 후에는 관리자 자격 증명을 추가할 수 없습니다. 이러한 자격 증명을 얻는 단계는 섹션을 참조하세요Atlassian 관리자 자격 증명 가져오기.

  6. 다음을 선택합니다.

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

지식 기반 생성

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

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

  3. Confluence URLs에서 포함하려는 Confluence 스페이스, 블로그 또는 페이지의 URLs을 붙여넣습니다. 각 URL 뒤에 추가를 선택합니다.

    참고

    구조를 따르는 URLshttps://company.atlassian.net/wiki/spaces/space-key/overview은 스페이스 URLs 아닌 페이지 URLs로 처리됩니다. 전체 스페이스를 인덱싱하려면를 사용하지 않고 스페이스 URL을 사용합니다/overview(예: https://company.atlassian.net/wiki/spaces/space-key).

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

추가 설정 구성

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

    ACLs 활성화하지 않으면 지식 기반 수준에서 액세스가 제어됩니다. 지식 기반에 액세스할 수 있는 사람은 누구나 지식 기반 내의 모든 콘텐츠에서 인사이트를 얻을 수 있습니다. ACLs 활성화되면 문서 수준에서 액세스가 제어됩니다. 지식 기반에 액세스할 수 있는 사용자는 Confluence에서 액세스할 수 있는 권한이 있는 문서의 답변만 볼 수 있습니다.

    중요

    지식 기반이 생성된 후에는 ACL 관리를 변경할 수 없습니다. 이 설정을 변경해야 하는 경우 새 지식 기반을 생성해야 합니다.

    참고

    인증 방법에서 Atlassian 관리자 자격 증명을 제공하지 않은 경우이 옵션은 비활성화됩니다. ACLs 활성화하려면 마법사 뒤로 또는 취소를 선택하고 관리자 자격 증명이 포함된 연결된 계정으로 다시 시작합니다.

  2. 멀티미디어 콘텐츠, 파일 크기 및 파일 패턴에서 필요에 따라 다음 인덱싱 옵션을 구성합니다.

    • 문서의 시각적 콘텐츠 - 문서에 포함된 이미지 및 차트와 같은 시각적 콘텐츠를 인덱싱합니다.

    • 오디오 파일 - 오디오 파일 첨부 파일을 인덱싱합니다.

    • 비디오 파일 - 비디오 파일 첨부 파일을 인덱싱합니다.

    • 최대 단일 파일 크기 - 개별 첨부 파일의 최대 파일 크기입니다(기본값: 50MB).

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

지원되는 콘텐츠 유형

  • Confluence 페이지 및 블로그 게시물

  • 페이지 및 블로그 게시물 첨부 파일

Confluence 스페이스 URL을 추가하면 Amazon Quick은 해당 스페이스 내의 모든 페이지와 블로그 게시물을 크롤링합니다. 지원되는 첨부 파일 유형 및 크기 제한은 섹션을 참조하세요파일 크기 및 콘텐츠 제한.

지식 기반 관리

기존 지식 기반 편집

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

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

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

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

문제 해결

통합을 편집, 공유 또는 삭제하려면 섹션을 참조하세요기존 통합 관리.

동기화 문제 및 누락된 문서를 포함한 일반적인 지식 기반 문제 해결은 섹션을 참조하세요지식 기반 문제 해결.

차단된 OAuth 앱 권한 부여

증상:

  • 오류 메시지: “앱이 계정에 액세스하려면 사이트 관리자가 사이트 instance-name.atlassian.net 대해이 앱을 승인해야 합니다.”

  • 동의 대화 상자에서 수락을 선택하면 효과가 없습니다.

원인:

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

해결 단계:

다음 옵션 중 하나를 사용하여이 문제를 해결합니다.

  • 옵션 1(권장): 관리자가 앱을 직접 승인합니다.

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

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

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

    관리자가 앱을 승인하면 사이트의 다른 모든 사용자가 문제 없이 연결할 수 있습니다.

  • 옵션 2: 사용자 설치 앱 임시 허용 - 관리자가 로 이동하여 앱, Atlassian 앱으로 admin.atlassian.com이동한 다음 타사 및 Marketplace 앱의 링크를 선택합니다. 설정에서 사용자 설치 앱을 찾아 사용자 앱을 허용하도록 전환합니다. 사용자가 Amazon Quick에 권한을 부여한 후 설정을 다시 전환하여 사용자 앱을 차단합니다.

중요

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

참고

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

인증 팝업 실패

증상:

  • 인증 팝업이 표시되지 않거나 즉시 닫힙니다.

  • 팝업이 표시되지만 OAuth 흐름을 완료하지 못합니다.

해결 단계:

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

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

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

지식 기반에 누락된 콘텐츠

증상:

  • 지식 기반 동기화는 완료되지만 예상 콘텐츠는 인덱싱되지 않습니다.

  • 검색 결과에는 특정 공백 또는 페이지의 콘텐츠가 포함되지 않습니다.

  • 전체 스페이스에 대해 하나의 문서만 인덱싱됩니다.

해결 단계:

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

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

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

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

ACL 관련 문제

ACL 지원 지식 기반의 결과 없음

  • 첫 번째 쿼리 중에 메시지가 표시되면 최종 사용자가 Confluence에 로그인했는지 확인합니다. 실시간 권한 확인을 위해서는 로그인이 필요합니다.

  • 최종 사용자가 Confluence 인스턴스의 관련 Confluence 콘텐츠에 액세스할 수 있는지 확인합니다.

동기화 중에 건너뛴 문서

  • 동기화 보고서에 SKIPPED 상태의 항목이 표시되면 인증 사용자가 지식 기반에 포함된 Confluence 스페이스 및 페이지에 액세스할 수 있는지 확인합니다.

  • 문서 액세스 확인에 대한 자세한 내용은 섹션을 참조하세요문서 액세스 확인(ACL 확인).