Confluence Data Center를 Rovo에 연결하기

Confluence Data Center의 페이지와 블로그 게시물을 Rovo에 통합하여 팀의 지식을 Data Center와 Cloud 사이트에서 중앙 집중화하세요.

인덱싱 대상 객체

Confluence DC 커넥터는 다음 객체들을 색인합니다:

  • 페이지 (Pages)

  • 블로그 게시물 (Blog posts)

  • 댓글 (Comments)

각 항목별로 인덱싱되는 속성

  • 이름 (Name)

  • URL

  • 생성일 (Created date)

  • 마지막 수정일 (Last updated date)

  • 작성자 (Creator)

  • 기여자 (Contributor)

  • 문서 본문 (Document body)

  • 스페이스 (Space)

  • 상위 페이지 전체 (All parent pages)

  • 페이지 조회 수 (Number of page views)

시작 전 준비사항

    • Rovo는 항상 권한을 존중합니다.
      사용자는 자신에게 접근 권한이 있는 콘텐츠만 볼 수 있습니다.

    • Confluence Data Center 커넥터는 다음 버전에서 지원됩니다:

      • Confluence 9.4 이상

      • 또는 9.2.6 LTS 이상

    • 속도 제한(rate limiting) 이 활성화되어 있는 경우,
      Rovo가 콘텐츠를 원활하게 인덱싱할 수 있도록 요청 제한(request limits) 을 조정해야 할 수 있습니다.

개요 – 연결 절차

Confluence Data Center를 Rovo에 연결하려면 다음 단계를 완료해야 합니다:

  1. 애플리케이션 터널을 생성하거나 허용 목록(allowlist)을 설정

    • 이 단계는 사설 네트워크에 호스팅된 Confluence 인스턴스에만 적용됩니다.

    • 공용 인터넷에서 접근 가능한 경우 이 단계는 생략 가능합니다.

  2. 수신 애플리케이션 링크 생성

  3. Atlassian Admin에서 커넥터 설정

Step 1: 애플리케이션 터널 설정 (선택 사항)

공용 인터넷에서 접근 가능하다면 이 단계는 생략하고 Step 2로 진행하세요.


Confluence Data Center 인스턴스가 사설 네트워크에 있는 경우, Cloud 조직에서 Confluence Data Center 인스턴스로 애플리케이션 터널(application tunnel) 을 설정해야 합니다.
기존 터널이 있다면, 구성을 조정하여 재사용할 수도 있습니다.
자세한 내용은 터널 관련 문서에서 확인할 수 있습니다.

또는, 터널을 사용하지 않으려는 경우, Atlassian Cloud 제품 및 사이트의 수신 연결 또는 IP를 허용 목록(allowlist)에 추가하여 Data Center 인스턴스에서 접근을 허용할 수 있습니다. 자세한 내용은 Atlassian Cloud 제품의 IP 주소 및 도메인에 대한 문서를 참조하세요.


  1. 새 터널 만들기 (Create a new tunnel)

    • 필수 연결 및 업스트림 포트를 구성합니다.

    • admin.atlassian.com에 접속합니다.

      • 여러 조직이 있는 경우, 해당 조직을 선택합니다. 

    • Settings > Application tunnels 로 이동합니다.

    • Create tunnel(터널 생성) 을 선택합니다.

    • 마법사 안내에 따라 자체 관리 인스턴스(self-managed instance) 정보를 입력하고, 해당 터널에 연결된 보안 키(security key) 를 생성합니다.

    • 생성된 보안 키를 Confluence Data Center 인스턴스에 추가합니다.

    • 인스턴스로 리디렉션하려면 Copy and process(복사 및 처리) 를 선택하세요.

    • 관리자에게 키를 전달하려면 Copy(복사) 후 Close(닫기) 를 클릭합니다.

    • 관리자는 Administration > Application tunnel > Add security key(보안 키 추가) 에서 직접 키를 수동으로 입력할 수 있습니다.

    • 마법사의 지시에 따라 보안 키를 붙여넣고(Paste) 나머지 단계를 완료합니다.

    • 터널이 생성되면, 상태가 ‘Connected(연결됨)’으로 바뀔 때까지 기다립니다.


  2. 기존 터널 사용하기 (Use an existing tunnel)

  • 기존의 애플리케이션 터널을 사용하려면, HTTP 커넥터 설정을 수정해야 합니다:

    1. Confluence가 설치된 디렉터리에서 conf/server.xml 파일을 엽니다.

    2. <Connector> 태그에 다음 속성을 추가합니다:

      xml

      secure="true"

필수 연결 및 업스트림 포트에 대한 자세한 내용은 관련 문서에서 확인하세요.


Step 2: 수신 애플리케이션 링크 생성

Confluence Data Center 인스턴스의 관리 페이지에서 애플리케이션 링크(application link) 를 생성하여 Rovo와의 연결에 사용합니다.

  • Confluence Data Center > 관리 > Application Links

  • Create link > External application > Incoming 선택 후 Continue 

  • 애플리케이션 링크의 이름 입력

  • 리디렉션 URL로 다음 주소를 입력합니다

  • 애플리케이션 권한(Application permissions) 에서는 Manage Subscriptions(구독 관리) 를 선택합니다.

  • Save 클릭

  • Actions(작업) 메뉴에서 More actions > View credentials

    • 생성된 Client ID와 Client Secret을 복사

    • 이 정보는 이후 Rovo에 연결 시 필요

Step 3: Atlassian Admin에서 커넥터 설정

Atlassian Admin에서 Confluence Data Center 커넥터의 설정 화면에 접근합니다.

  1. admin.atlassian.com으로 이동

  2. 조직 선택 후 Settings > Rovo

  3. 연결할 사이트 옆에서 Add connector 클릭

  4. Confluence Data Center 선택 후 Next

Confluence Data Center 설정

  • 연결 이름 입력

  • 네트워크 유형 선택:

    • Private network: 앞서 생성한 애플리케이션 터널 선택 - 방화벽 등으로 인해 공용 인터넷에서 접근할 수 없는 경우.

    • Public network: 서버 URL 직접 입력 (context path 포함 가능) - Confluence 인스턴스가 공용 인터넷에서 접근 가능하거나,
      터널 대신 수신 연결 또는 IP를 허용 목록에 등록한 경우.

  • 이전 단계에서 생성한 OAuth Client ID와 Client Secret 입력

  • 면책 조항 확인

  • Authorize Confluence Data Center 클릭

연결 후 다음 단계

  • 연결 후, 팀원들은 검색 필터 옵션에서 Confluence Data Center를 확인할 수 있습니다.

  • 검색 결과를 보기 위해서는 개별적으로 Confluence DC에 연결하라는 요청을 받을 수 있습니다..

  • 이는 사용자가 본인이 접근할 수 있는 콘텐츠만 보도록 보장하기 위한 절차입니다.

  • Confluence Data Center 인스턴스에 저장된 콘텐츠의 양에 따라, 모든 콘텐츠가 인덱싱되고 Rovo에 표시되기까지 시간이 다소 걸릴 수 있습니다.


  • 레이블 없음