Skip to main content

​
Docusign 정보

Iru는 OAuth 2.0 JWT Grant를 사용하여 eSignature REST API를 호출합니다. Integration Key(클라이언트 ID)를 등록하고, RSA 공개 키를 업로드하고, 서비스 사용자에 대한 가장(impersonation) 동의를 부여하면, Iru가 서명된 JWT를 액세스 토큰으로 교환합니다. 이 방식은 매시간 대화형 동의 없이 서버 간 자동화에 적합합니다.

​
작동 방식

DocuSign은 여러 OAuth 2.0 부여 유형을 지원합니다. Iru의 서버 간 커넥터에는 JWT Grant가 적합한 모델입니다. Integration Key(클라이언트 ID)를 생성하고, RSA 키 쌍을 구성하고, Iru가 대신 동작할 사용자에 대해 가장 동의를 한 번 부여하면, Iru가 eSignature REST API에 대해 서명된 JWT를 액세스 토큰으로 교환합니다. 주요 단계: Apps and Keys → Integration Key 생성 → JWT 인증 → RSA 생성 또는 업로드 → Iru 마법사에 따라 Integration Key, 가장할 사용자 GUID, 계정 기본 URI 및 개인 키 확보. 공식 참고 자료: 플랫폼 인증, JWT Grant, 통합 빌드, eSignature REST.

​
사전 요구 사항

  • Docusign의 관리자 액세스 권한.
  • 통합을 관리할 수 있는 developers.docusign.com 액세스 권한.
  • 데모 키와 프로덕션 키 및 OAuth 호스트(account-d.docusign.com 또는 account.docusign.com) 중 무엇을 사용할지 명확한 결정.

​
Docusign을 Iru에 연결

Compliance에서 소스를 연결하기 전에 이 탭을 완료하세요.
1

Apps and Keys 열기

올바른 Docusign 환경(데모 또는 프로덕션)에 로그인합니다. 설정 → Apps and Keys를 엽니다(계정 유형에 따라 문구가 약간 다를 수 있음).
2

앱 및 통합 키 추가

Add App and Integration Key(또는 Create app)를 선택합니다. 운영자가 알아볼 수 있도록 앱 이름을 지정합니다(예: Iru Compliance). Integration Key를 복사합니다. 이 값이 JWT용 OAuth 클라이언트 ID입니다.
3

JWT Grant 활성화

앱의 인증 설정에서 서버 간 사용을 위해 JWT Grant를 활성화합니다. Docusign에서 메시지가 표시되면 변경 사항을 저장합니다.
4

RSA 키 생성 또는 업로드

Service Integration에서 Generate RSA를 선택합니다(또는 Docusign 문서에 따라 공개 키를 업로드). 개인 키를 즉시 다운로드하여 볼트에 보관하세요. 나중에 Docusign에서 개인 키를 다시 가져올 수 없습니다.
5

가장 동의 부여

Docusign에서 JWT용으로 제공하는 동의 URL을 엽니다(범위에는 일반적으로 signature 및 impersonation 범위이 포함됨). 가장할 사용자로 로그인하고 허용을 선택합니다. 앱 등록에 필요한 리디렉션을 완료합니다.
Iru Compliance 탭에서 계속 진행하세요.

​
문제 해결

Iru 사이트의 팝업 차단 설정을 확인한 후 다시 시도하세요.
개인 키가 업로드한 공개 키와 일치하는지, 서버 시계가 정확한지 확인하세요.
Docusign 계정 메타데이터에서 리전별 restapi 호스트를 확인하세요.
키와 OAuth 호스트가 환경과 일치해야 합니다.

​
고려 사항

액세스 토큰은 약 1시간마다 만료되며 JWT Grant가 다시…

액세스 토큰은 약 1시간마다 만료되며 JWT Grant가 자동으로 다시 실행됩니다. RSA 개인 키는 프로덕션 시크릿처럼 보호하세요.

​
관련 문서

Sources 관리

모든 Compliance 소스를 찾아보고 관리합니다.

Compliance 시작하기

프레임워크, 작업 및 아티팩트.

Iru 개요

Endpoint, Compliance 및 Identity가 함께 작동하는 방식.

Artifacts 관리

소스 및 작업에서 수집한 증거를 업로드, 검토 및 정리합니다.