DocuSign과(와) 통합

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 9분

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

    DocuSign 리셀러를 통한 구매는 표준 결제 시스템에 반영 DocuSign 되지 않습니다. 따라서 사용할 수 ServiceNow있는 봉투 소비에 대한 API를 통해 값이 반환되지 않습니다.

    중요사항:
    DocuSign 이(가) 사용자 API에서 lastLogin 필드를 제거했으므로 사용자의 마지막 활동은 더 이상 이 통합의 일부로 추적되지 않습니다. 소프트웨어 자산 관리 이제 애플리케이션은 구독 할당 날짜를 기반으로 재생 후보를 생성합니다.

    서비스에 대한 DocuSign 자세한 내용은 DocuSign 개발자 사이트를 참조하십시오.

    중요사항:
    필요한 사용자 또는 API 권한에만 액세스 권한을 부여하여 보안 위험을 최소화하고 정보를 보호합니다.
    표 1. 최소 사용자 권한
    프로세스 애플리케이션에서 필요한 사용자 역할 DocuSign 인증 범위
    구독 다운로드 관리자 범위 없음
    구독 회수 관리자 범위 없음

    DocuSign 애플리케이션 등록

    관리 포털을 통해 애플리케이션을 등록합니다 DocuSignDocuSign .

    시작하기 전에

    DocuSign 필요한 역할: admin

    프로시저

    1. DocuSign 데모(비프로덕션) 계정에 로그인합니다.
    2. 프로필 사진을 선택합니다.
    3. 내 앱 및 키를 선택합니다.
      • 프로덕션에서 사용할 준비가 된 이전 통합의 API 통합 키가 이미 있는 경우 33단계로 건너뛰십시오.
      • 저장된 클라이언트 비밀이 없는 경우 새 클라이언트 비밀을 생성해야 합니다.
    4. 왼쪽 창에서 통합 > 앱 및 키.
    5. 앱 및 통합 키 섹션에서 앱 및 통합 키 추가를 선택합니다.
    6. 통합 키 추가 양식에서 앱 이름 필드에 이름을 입력하고앱 생성을 선택합니다.
    7. 추가 설정 섹션의 리디렉션 URI 필드 아래에서 URI 추가를 선택합니다.
    8. https://oauth.pstmn.io/v1/browser-callback 추가합니다.
    9. URI 추가를 다시 선택하고 https:// ServiceNow instance.service-now.com/oauth_redirect.do 를 추가합니다.
    10. 비밀 키 추가를 선택합니다.
      통합 키(클라이언트 ID) 및 비밀 키(클라이언트 비밀)를 안전한 위치에 저장하여 나중에 Postman 앱에서 사용하고 인스턴스의 통합 키(클라이언트 ID) ServiceNow 에서 사용할 수 있습니다.
    11. 저장을 선택합니다.
    12. 최신 버전의 Postman 앱을 다운로드하고 로그인을 건너뜁니다.
    13. 선택 새 컬렉션 컬렉션에 이름을 입력합니다.
    14. 권한 부여 탭을 선택합니다.
    15. 유형 목록 메뉴에서 OAuth 2.0을 선택합니다.
    16. 이름을 입력하고 구성 옵션 탭의 필드를 작성하여 토큰을 작성합니다.
      필드 값
      콜백 URL https://oauth.pstmn.io/v1/browser-callback
      인증 URL https://account-d.docusign.com/oauth/auth
      접근 토큰 URL https://account-d.docusign.com/oauth/token
      클라이언트 ID 10단계에서 만든 데모 계정의 통합 키 DocuSign 입니다.
      클라이언트 비밀 데모 계정의 비밀 키 DocuSign10단계입니다.
    17. 새 접근 토큰 가져오기를 선택합니다.
      로 리디렉션됩니다 DocuSign.
    18. 수락을 선택합니다.
    19. 액세스 토큰이 수집되고 인증이 완료되면 액세스 토큰을 복사하여 나중에 사용합니다.
    20. 새 요청을 선택하여 계정 ID에 대한 GET 요청을 생성합니다.
    21. GET 필드에 URL을 https://account-d.docusign.com/oauth/userinfo 로 입력합니다.
    22. 헤더 탭의 키 아래에서 권한 부여를 선택하고 값 아래에 전달자 <인증 중에 복사한 액세스 토큰> 을 입력합니다.
    23. 보내기를 선택하고 요청이 완료되었는지 확인합니다.
      계정 ID가 응답 본문에 표시됩니다.
    24. GET 요청을 복제합니다.
      헤더 아래에서 인증 키와 값을 복사합니다.
    25. GET 필드의 URL을 https://demo.docusign.net/restapi/v2/accounts/<account-id>/users로 업데이트합니다.
      여기서 account-id 는 이전 요청에서 저장한 ID입니다.
    26. 보내기를 20회 선택하여 20개의 API 호출을 수행합니다.
      관리 포털을 통해 DocuSign 애플리케이션을 등록하려면 최소 20개의 API 호출을 호출해야 합니다.
    27. 관리 포털에서 DocuSign앱 및 통합 키로 이동합니다.
    28. 선택 작업 > API 대시보드 보기 애플리케이션 옆에 있습니다.
    29. 20개의 API 호출이 모두 등록될 때까지 DocuSign 몇 분 정도 기다립니다.
    30. 다음으로 이동 통합 > 앱 및 키 을 클릭하고 검토를 위해 제출을 선택합니다.
      5-20분 후에 애플리케이션 검토가 완료됩니다. 애플리케이션을 프로덕션 계정으로 승격할 수 있습니다.
    31. 선택 작업 > Start-Go-Live 검토 애플리케이션을 프로덕션 계정으로 승격하기 위해
    32. 통합 키를 관리할 적격 프로덕션 계정을 선택하십시오.
    33. DocuSign 프로덕션 콘텐츠 계정에 로그인합니다.
    34. 프로필 사진을 선택합니다.
    35. 관리자로 이동을 선택합니다.
    36. 왼쪽 창에서 통합 > 앱 및 키.
      인스턴스에서 통합 프로파일에 사용할 API 계정 ID를 ServiceNow 찾습니다.
    37. 애플리케이션 옆에 있는 선택 작업 > 편집.
    38. URI 추가를 선택하고 https:// ServiceNow instance.service-now.com/oauth_redirect.do 를 추가합니다.
    39. 비밀 키 추가를 선택합니다.
      프로덕션 계정의 비밀 키(클라이언트 비밀)를 인스턴스에서 사용할 ServiceNow 수 있도록 안전한 위치에 저장합니다.
    40. 저장을 선택합니다.

    DocuSign 통합 프로파일 생성

    통합 프로파일을 생성하여 소프트웨어 구독을 추적하고 서비스 라이센스를 최적화합니다 DocuSign .

    시작하기 전에

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

    ServiceNow 필요한 역할: sam_integrator 또는 admin

    이 태스크 정보

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

    프로시저

    1. 통합 프로파일로 이동합니다.
      인터페이스작업
      코어 UI
      1. 다음으로 이동 모두 > 소프트웨어 자산 > SaaS 라이선스 > 직접 통합 프로 파일.
      2. 새로 만들기를 선택합니다.
      3. DocuSign 통합 프로파일을 선택합니다.
      소프트웨어 자산 작업 공간
      1. 다음으로 이동 라이센스 운영 > 사용자 구독 > 직접 통합 프로파일.
      2. 새로 만들기를 선택합니다.
      3. 드롭다운 목록에서 DocuSign 을 선택합니다.
      4. 계속을 선택합니다.
    2. 양식에서 필드를 채웁니다.
      표 2. 통합 프로파일 양식
      필드 값
      표시 이름 통합 프로파일의 이름입니다. 예: DocuSign 통합
      클라이언트 ID 관리자 계정의 10단계에서 만든 OAuth 애플리케이션의 클라이언트 ID입니다 SaaS .
      리디렉션 URL 인증 후 리디렉션되는 OAuth 제공자의 URL입니다. 이 값은 자동으로 채워집니다.
      기술 계정 ID 프로덕션 계정의 API 계정 ID입니다 DocuSign .
      인스턴스 URL 프로덕션 계정에 접근하는 데 사용되는 로그인 페이지의 URL입니다 DocuSign . 이 필드는 https://account.docusign.com 로 자동 설정됩니다.
      클라이언트 비밀 39단계에서 만든 클라이언트 ID와 연결된 암호입니다.
      프로파일 유형 통합 프로파일의 유형입니다. 이 값은 DocuSign 구독으로 자동 설정됩니다.
    3. 각 프로세스의 벤더 구성 필드에 지정된 필수 사용자 역할 또는 API 권한을 검토하여 보안 위험을 최소화하고 라이센스를 최적화 SaaS 합니다.
      주:
      필요한 역할 및 범위에 대한 자세한 내용은 최소 사용자 권한 테이블을 참조하십시오.

      • 구독 다운로드 확인란은 기본적으로 선택되어 있으며 선택을 취소할 수 없습니다.

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

    4. 제출을 선택합니다.
      ServiceNow 인스턴스가 초안 통합 프로파일을 생성합니다.
    5. 통합 프로파일에서 OAuth 토큰 가져오기 를 선택하고 단계에 따라 OAuth 토큰을 가져옵니다.
      주:
      이 단계를 수행하는 데 필요한 역할은 최소 사용자 권한 테이블을 참조하십시오.
    6. 통합 프로파일 양식에서 연결 확인을 선택하여 이 통합의 연결 및 자격 증명 상세 정보를 확인합니다.

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

    결과

    현재 날짜로부터 최대 1년 전까지 개별 사용자가 수행한 이벤트를 볼 수 있습니다. 자세한 내용은 을 참조하십시오 소프트웨어 재생 규칙 검토. 소프트웨어 자산 관리 는 프로파일 생성 날짜와 관계없이 사용자 구독 다운로드를 시작한 시점부터 이벤트를 가져옵니다.

    다음에 수행할 작업

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

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

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

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

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

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