Confluence Cloud과(와) 통합

애플리케이션을 애플리케이션과 Confluence Cloud 통합 소프트웨어 자산 관리 하면 소프트웨어 구독을 추적하고 사용하지 않은 라이센스를 회수할 수 있습니다.

현재 이 통합은 프로파일당 하나의 사이트 통합만 지원합니다.

중요사항:

필요한 사용자 또는 API 권한에만 액세스 권한을 부여하여 보안 위험을 최소화하고 정보를 보호합니다.

표 1. 최소 사용자 권한

프로세스	애플리케이션에서 필요한 사용자 역할 Confluence Cloud	인증 범위
구독 다운로드	Confluence 제품의 사용자 역할	사용자 그룹 읽기(read:confluence-groups) 읽기 사용자(read:confluence-user)
사용자 활동 끌어오기	Confluence 제품의 사용자 역할	Confluence 콘텐츠 및 공간 요약 검색(search:confluence)
구독 회수	사이트 관리자	사용자 그룹 읽기(read:confluence-groups) 사용자 그룹 생성, 제거 및 업데이트(write:confluence-groups)

Confluence Cloud OAuth 2.0(3LO) 애플리케이션 생성

Confluence Cloud API에 Confluence Cloud 액세스할 수 있도록 OAuth 2.0(3LO) 애플리케이션을 생성합니다.

시작하기 전에

Atlassian 필요한 역할: 최소 사용자 권한 테이블을 참조하십시오.

프로시저

1. 웹 브라우저에서 Atlassian 개발자 포털을 엽니다.
2. 사이트 관리자 계정에 로그인합니다.
3. 포털의 페이지 헤더에서 프로필 아이콘을 선택한 다음, 개발자 콘솔을 선택합니다.
   개발자 콘솔의 Atlassian 내 앱 페이지가 열립니다.
4. 앱 생성 메뉴를 선택한 다음 OAuth 2.0(3LO) 통합을 선택합니다.
   새 OAuth 2.0(3LO) 통합 생성 페이지가 열립니다.
5. 이름 필드에 OAuth 2.0(3LO) 애플리케이션의 이름을 입력합니다.
6. Atlassian의 개발자 약관에 동의함 확인란을 선택한 다음 생성을 선택합니다.
7. 애플리케이션에 대한 권한 부여 설정을 구성합니다.
   1. 왼쪽 탐색 창에서 권한 부여를 선택합니다.
   2. OAuth 2.0(3LO) 권한 부여 유형에 대해 구성을 선택합니다.
      앱에 대한 OAuth 2.0 인증 코드 부여(3LO) 페이지가 열립니다.
   3. 콜백 URL 필드에 사용자가 인증 후 리디렉션되는 OAuth 제공자의 URL을 입력합니다.
      https:// instance.service-now.com/oauth_redirect.do 를 입력합니다. 여기서 <instance>는 인스턴스의 이름입니다ServiceNow.
   4. 변경 사항 저장을 선택합니다.
8. 애플리케이션에 대한 API 범위를 구성합니다.
   API 범위는 애플리케이션이 API에 대해 Atlassian 갖는 액세스 수준을 지정합니다.
   1. 왼쪽 탐색 창에서 권한을 선택합니다.
   2. 사용 가능한 API 목록에서 Confluence API를 찾은 다음 추가를 선택합니다.
      작업 추가 버튼은 작업 구성 버튼으로 자동 변경됩니다.
   3. 구성을 선택합니다.
      Confluence API 페이지가 열립니다.
   4. Confluence API에 대해 다음 범위를 추가합니다.
      • Confluence 콘텐츠 및 공간 요약 검색
      • 사용자 그룹 읽기
      • 사용자 그룹 생성, 제거 및 업데이트
      • 사용자 읽기
9. 애플리케이션에 할당된 클라이언트 ID 및 클라이언트 비밀을 검색합니다.
   1. 왼쪽 탐색 창에서 설정을 선택합니다.
   2. 인증 상세 정보 섹션에서 클라이언트 ID 및 비밀 필드의 값을 복사합니다.
      나중에 사용할 수 있도록 안전한 위치에 저장하십시오.

인스턴스의 클라우드 ID 값 Confluence Cloud 얻기

클라우드 인스턴스의 클라우드 ID Confluence Cloud 값을 가져옵니다. 이 값은 인스턴스에서 연결 기록을 ServiceNow 구성하는 동안 필요합니다.

시작하기 전에

Confluence Cloud 필요한 역할: admin

프로시저

1. Atlassian 관리에 로그인합니다.
2. 필요한 조직에 대해 선택 버튼을 선택합니다.
3. 제품 탭을 선택합니다.
4. 제품 페이지의 Confluence 제품 행에서 제품 관리를 선택합니다.

   URL은 새 창에서 https://admin.atlassian.com/o/<orgID>/products/conf/<Cloud-Id> 형식으로 표시됩니다.

5. 나중에 사용할 수 있도록 클라우드 ID의 값을 복사합니다.

Confluence Cloud 통합 프로파일 생성

Confluence Cloud 통합 프로파일을 생성하여 소프트웨어 구독을 추적하고 애플리케이션에 대한 라이센스를 최적화합니다Confluence Cloud.

시작하기 전에

통합 프로파일을 생성하려면 Confluence CloudServiceNow Store에서 소프트웨어 자산 관리 플러그인SaaS 라이선스 관리(sn_sam_saas_int)을 요청하십시오.

Atlassian 필요한 역할: 사이트 관리자

ServiceNow 필요한 역할: sam_integrator, sn_confluence_spoke.confluence_cloud_admin

중요사항:

페이지에 선택적 기능을 Application Manager 설치하는 동안 이 통합에 대한 Confluence Cloud 스포크 확인란을 선택해야 합니다. 필요한 SaaS 애플리케이션 선택에 대한 자세한 내용은 다음 문서를 참조하십시오 SaaS 라이선스 관리 요청.

이 태스크 정보

를 사용하는 소프트웨어 자산 작업 공간경우 통합 프로파일을 코어 UI 생성하는 Confluence Cloud 옵션이 비활성화됩니다.

프로시저

1. 통합 프로파일로 이동합니다.

   인터페이스	작업
   코어 UI	다음으로 이동 모두 > 소프트웨어 자산 > SaaS 라이선스 > 직접 통합 프로 파일. 새로 만들기를 선택합니다. Confluence Cloud 통합 프로파일을 선택합니다.
   소프트웨어 자산 작업 공간	다음으로 이동 라이센스 운영 > 사용자 구독 > 직접 통합 프로파일. 새로 만들기를 선택합니다. 드롭다운 목록에서 Confluence Cloud 를 선택합니다. 계속을 선택합니다.

2. 양식에서 필드를 채웁니다.

   표 2. 통합 프로파일 양식

   필드	값
   표시 이름	통합 프로파일의 이름입니다. 예를 들어 Confluence Cloud 통합입니다.
   상태	통합 프로파일의 상태입니다. 통합 프로파일을 게시하지 않은 경우 이 필드는 초안으로 자동 설정됩니다. 통합 프로파일을 이미 게시한 경우 이 필드는 게시됨으로 자동 설정됩니다.
   프로파일 유형	통합 프로파일의 유형입니다. 이 필드는 Confluence Cloud 구독으로 자동 설정됩니다.

3. 각 프로세스의 벤더 구성 필드에 지정된 필수 사용자 역할 또는 API 권한을 검토하여 보안 위험을 최소화하고 라이센스를 최적화 SaaS 합니다.
   주:

   자세한 내용은 최소 사용자 권한 테이블을 참조하십시오.
   1. 구독 하위 플로우 다운로드 섹션에서 하위 플로우 필드가 Confluence Cloud 다운로드 구독으로 설정되어 있는지 확인합니다.
      주:

      구독 다운로드 확인란은 기본적으로 선택되어 있으며 선택을 취소할 수 없습니다.
   2. 활동 하위 플로우 계산 섹션에서 하위 플로우 필드가 Confluence Cloud 사용자 활동 업데이트로 설정되어 있는지 확인합니다.
      주:

      활동 다운로드 확인란은 기본적으로 선택되어 있습니다. 선택을 취소하면 활동 예약된 작업이 SAM - Refresh <displayname> Activity 생성되지 않습니다.

      사용자 활동 분석 필드에서 사용자 활동을 분석하려는 시작 날짜 및 시간을 선택할 수도 있습니다. 기본적으로 현재 날짜로부터 최대 60일 전의 사용자 활동을 분석하고 이 프로파일을 생성한 시점부터 개별 사용자가 수행한 이벤트를 볼 수 있습니다.

      주:

      소프트웨어 자산 관리 는 프로파일 생성 날짜와 관계없이 사용자 활동 분석을 시작한 시점부터 이벤트를 가져옵니다.

      소프트웨어 재생 규칙의 마지막 활동 임계치 필드에서 이 값을 수정할 수 있습니다. 자세한 내용은 소프트웨어 재생 규칙 검토 문서를 참조하십시오.
   3. 구독 회수 하위 플로우 섹션에서 하위 플로우 필드가 Confluence Cloud 구독 회수로 설정되어 있는지 확인합니다.
      주:

      구독 회수 확인란은 기본적으로 선택되어 있습니다. 구독을 회수하지 않으려면 이 확인란의 선택을 취소할 수 있습니다. 선택을 취소하면 제거 후보가 생성되지만 구독 회수 하위 플로우가 트리거되지 않거나 재생 프로세스가 시작되지 않습니다.
4. 저장을 선택합니다.
   초안 통합 프로파일이 생성됩니다.

   연결 및 자격 증명 필드가 나타나고 모든 프로세스가 선택되면 sn_conflunce_spoke.confluence_subscription_activity_reclaim으로 자동 설정됩니다.

   주:

   연결 및 자격 증명 필드에 자동으로 채워진 값은 다운로드 활동 및 구독 회수 확인란의 선택에 따라 변경됩니다.

   표 3. 선택에 따라 자동으로 채워지는 연결 및 자격 증명 값

   선택	연결 및 자격 증명 값
   다운로드 활동과 구독 회수가 모두 선택됩니다.	sn_conflunce_spoke.confluence_subscription_activity_reclaim
   다운로드 활동만 선택됩니다.	sn_conflunce_spoke.confluence_subscription_activity
   구독 회수만 선택됩니다.	sn_conflunce_spoke.confluence_subscription_reclaim
   다운로드 활동과 구독 회수가 모두 선택되지 않았습니다.	sn_conflunce_spoke.confluence_subscription

5. 연결 및 자격 증명 필드 옆에 있는 미리 보기 아이콘(. )을 선택한 다음 기록 미리 보기에서 기록 열기를 선택하여 연결 및 자격 증명 별칭 기록을 엽니다.
6. 연결 및 자격 증명 별칭 양식에서 새 연결 및 자격 증명 생성 관련 링크를 선택합니다.
7. 대화 상자에서 필드에 내용을 입력합니다.

   표 4. 연결 및 자격 증명 생성 대화 상자

   필드	설명
   이름	연결의 이름입니다.
   연결 URL	인스턴스의 URL Confluence Cloud 을 https://api.atlassian.com/ex/confluence/<Cloud-ID 형식으로 제공합니다. 클라우드 ID의 값을 가져오는 방법에 대한 자세한 내용은 다음 문서를 참조하십시오 인스턴스의 클라우드 ID 값 Confluence Cloud 얻기.
   OAuth 클라이언트 ID	OAuth 2.0(3LO) 애플리케이션에 할당된 Confluence Cloud 클라이언트 ID입니다.
   OAuth 클라이언트 비밀	OAuth 2.0(3LO) 애플리케이션에 할당된 Confluence Cloud 클라이언트 비밀입니다.
   OAuth 리디렉션 URL	사용자가 인증 후에 리디렉션되는 OAuth 제공자의 URL입니다. 이 필드는 에서 Confluence Cloud OAuth 2.0(3LO) 애플리케이션 생성지정한 콜백 URL에 따라 자동으로 채워집니다.

8. OAuth 토큰 생성 및 가져오기를 선택합니다.
   주:

   이 단계를 수행하는 데 필요한 역할은 최소 사용자 권한 테이블을 참조하십시오.
9. 대화 상자가 나타나면 애플리케이션에 권한을 Confluence Cloud 부여합니다.
   대화 상자가 닫히고 연결 및 자격 증명 별칭 양식으로 자동 돌아갑니다.
10. Confluence 제품에 액세스할 수 있는 그룹을 지정합니다.
    인스턴스에 이러한 그룹을 ServiceNow 지정하면 데이터를 검색하고 이러한 그룹 내의 사용자에 대해서만 라이센스를 관리할 수 있습니다.
    1. 새 탭에서 Atlassian 관리 포털을 엽니다.
    2. site_admin 역할로 관리자 계정에 로그인합니다.
    3. 필요한 조직에 대해 선택 버튼을 선택합니다.
    4. 제품 탭을 선택합니다.
    5. 제품 페이지의 Confluence 제품 행에서 제품 관리를 선택합니다.
    6. Confluence 제품에 액세스할 수 있는 그룹 목록을 봅니다.
       나중에 사용할 수 있도록 이 정보를 기록해 둡니다.
    7. 인스턴스로 ServiceNow 돌아가서 Confluence 클라우드 > Confluence 그룹.
    8. Confluence 그룹 양식에서 그룹 추가 관련 링크를 선택합니다.
       Confluence 그룹 추가 대화 상자가 열립니다.
    9. 통합 프로파일에 설정된 연결 및 자격 증명을 선택합니다.
    10. 사용 가능 목록에서 Confluence 제품에 액세스할 수 있는 그룹을 선택합니다.
        팁:

        사용 가능 목록에는 계정과 Atlassian 연결된 모든 그룹이 포함됩니다. Confluence 제품에 액세스할 수 있는 그룹만 선택합니다.
    11. 오른쪽 화살표 버튼을 선택하여 그룹을 사용 가능 목록에서 선택됨 목록으로 이동합니다.
    12. 확인을 선택합니다.
11. 통합 프로파일로 돌아간 다음, 통합 프로파일을 선택합니다.
12. 통합 프로파일 양식에서 연결 확인을 선택하여 이 통합의 연결 및 자격 증명 상세 정보를 확인합니다.

    연결을 확인하면 구독 다운로드 및 활동 계산 API가 확인되지만 구독 회수 API는 확인되지 않습니다.

13. 연결이 확인되면 게시를 선택합니다.
14. 게시 확인 대화 상자에서 확인을 선택합니다.
    주:

    통합 프로파일이 게시된 후 활동 다운로드 확인란의 선택을 취소하면 다음 이벤트가 발생하기 때문에 연결을 다시 확인한 다음 통합 프로파일을 다시 게시해야 합니다.

    • 통합 프로파일 양식의 상태 필드가 초안으로 변경됩니다.
    • 연결 확인 버튼이 양식에 나타납니다.
    • 현재 SAM - Refresh <displayname> Activity 작업이 삭제됩니다.

다음에 수행할 작업

통합이 연결되면 ServiceNow 인스턴스가 매일 새로 고침되는 소프트웨어 모델, 재생 규칙 및 소프트웨어 구독을 자동으로 생성합니다.

통합 프로파일을 생성한 후에는 다음으로 이동하여 프로파일 소프트웨어 자산 작업 공간 에 대한 정보를 봅니다. 라이센스 운영 > 사용자 구독 > 직접 통합 프로파일. 통합 프로파일을 선택하면 다음과 같은 관련 목록을 볼 수 있습니다. 기본 뷰에서 통합 프로파일에 대해 다음 관련 목록이 모두 표시되지 않는 경우 상세 정보 탭에서 사용자 지정 통합 뷰를 선택할 수 있습니다.

• 소프트웨어 모델
• 구독 식별자 미 승인됨
• 예약된 작업
• 예약된 작업 결과
• 소프트웨어 구독
• 구독 식별자 제외 규칙
• 구독 사용자 제외 규칙

통합 프로파일을 생성한 후에는 특정 구독이 라이센스 비용 계산에 포함되지 않도록 구독 제외 규칙을 정의할 수 있습니다. 자세한 내용은 및 SSO 애플리케이션에 대한 SaaS 구독 제외 문서를 참조하십시오.

고유한 연결을 사용하여 여러 통합 프로파일을 설정하려면 하위 별칭을 생성하여 각 통합 프로파일에 대해 서로 다른 구성 및 설정을 관리합니다. 자세한 내용은 여러 Confluence Cloud 통합 프로파일을 설정하려면 하위 별칭을 생성합니다. 문서를 참조하십시오.

자동으로 생성된 모든 재생 규칙을 검토하여 사용자 구독을 회수합니다. 자세한 내용은 소프트웨어 재생 규칙 검토 문서를 참조하십시오.

자동으로 생성된 소프트웨어 모델에 대한 소프트웨어 권리를 생성하여 사용된 소프트웨어를 소유한 소프트웨어와 비교하여 추적합니다.

• 코어 UI에서 소프트웨어 자산 관리 소프트웨어 권리를 만드는 방법에 대한 자세한 내용은 문서를 참조하십시오 클래식에서 소프트웨어 자산 관리 권리 생성.
• 소프트웨어 자산 작업 공간에서 소프트웨어 권리를 만드는 방법에 대한 자세한 내용은 다음 항목을 참조하십시오 작업 공간에서 권리 생성.
• 플레이북을 소프트웨어 자산 관리 사용하여 소프트웨어 권리를 생성하는 방법에 대한 자세한 내용은 문서를 참조하십시오 가이드가 있는 워크스루를 사용하여 권리 생성.

조정은 구독에서 예약된 작업 또는 요청 시에도 실행됩니다. 조정 결과는 라이센스 워크벤치(소프트웨어 자산 관리클래식 애플리케이션) 또는 라이센스 사용량 뷰(소프트웨어 자산 작업 공간)에서 볼 수 있습니다. 이러한 결과를 사용하여 라이센스 준수 위치를 결정하고 미준수 문제를 해결합니다.

• 클래식 애플리케이션에서 조정을 소프트웨어 자산 관리 실행하는 방법에 대한 자세한 내용은 문서를 참조하십시오 클래식에서 소프트웨어 자산 관리 소프트웨어 조정 실행.
• 소프트웨어 자산 작업 공간에서 조정을 실행하는 방법에 대한 자세한 내용은 다음 문서를 참조하십시오 작업 공간에서 소프트웨어 조정 실행.