> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Docusign

> 통합 키, RSA 키 쌍 및 동의를 사용하는 OAuth JWT Grant로 Docusign을 Iru Compliance에 연결하고 봉투(envelope) 및 계정 증거를 수집합니다.

### 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**를 **액세스 토큰**으로 교환합니다.

| 세부 정보 | 값 |
| - | - |
| **카테고리** | 생산성 |
| **인증** | OAuth 2.0 JWT Grant |

주요 단계: **Apps and Keys** → **Integration Key** 생성 → **JWT** 인증 → **RSA** 생성 또는 업로드 → Iru 마법사에 따라 **Integration Key**, 가장할 사용자 **GUID**, **계정 기본 URI** 및 **개인 키** 확보.

공식 참고 자료: [플랫폼 인증](https://developers.docusign.com/platform/auth/), [JWT Grant](https://developers.docusign.com/platform/auth/jwt/jwt-get-token/), [통합 빌드](https://developers.docusign.com/platform/build-integration/), [eSignature REST](https://developers.docusign.com/docs/esign-rest-api/).

### 사전 요구 사항

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

### Docusign을 Iru에 연결

<Tabs>
  <Tab title="Docusign">
    <Note>
      Compliance에서 소스를 연결하기 전에 이 탭을 완료하세요.
    </Note>

    <Steps>
      <Step title="Apps and Keys 열기">
        올바른 Docusign 환경(**데모** 또는 **프로덕션**)에 로그인합니다. **설정** → **Apps and Keys**를 엽니다(계정 유형에 따라 문구가 약간 다를 수 있음).
      </Step>

      <Step title="앱 및 통합 키 추가">
        **Add App and Integration Key**(또는 **Create app**)를 선택합니다. 운영자가 알아볼 수 있도록 앱 이름을 지정합니다(예: **Iru Compliance**). **Integration Key**를 복사합니다. 이 값이 JWT용 OAuth **클라이언트 ID**입니다.
      </Step>

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

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

      <Step title="가장 동의 부여">
        Docusign에서 JWT용으로 제공하는 **동의 URL**을 엽니다(범위에는 일반적으로 **`signature`** 및 **`impersonation`** 범위이 포함됨). **가장할 사용자**로 로그인하고 **허용**을 선택합니다. 앱 등록에 필요한 리디렉션을 완료합니다.
      </Step>
    </Steps>

    <Note>
      [**Iru Compliance**](#iru-compliance) 탭에서 계속 진행하세요.
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      먼저 [**Docusign**](#docusign) 탭을 완료하세요.
    </Note>

    <Steps>
      <Step title="소스 열기">
        Iru Compliance의 왼쪽 탐색 모음에서 **컴플라이언스**를 펼치고 **소스**를 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/tI0HDLDwHj8r9Ile/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=tI0HDLDwHj8r9Ile&q=85&s=87dcef15fc17d2fb9a6e53f454e41710" alt="왼쪽 탐색: Compliance가 펼쳐지고 Sources가 선택됨" width="410" height="1024" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Docusign 켜기">
        **Docusign**을 찾습니다(**범주** 또는 **이름 또는 설명으로 검색** 사용). 해당 카드에서 **토글**을 켭니다. 커넥터 마법사용 브라우저 탭 또는 창이 열릴 수 있습니다.
      </Step>

      <Step title="Integration Key 및 사용자 ID 입력">
        마법사에서 **Integration Key**(**클라이언트 ID**)와 Docusign이 대신 동작할 계정의 가장할 사용자 **ID**(**GUID**)를 붙여 넣습니다.
      </Step>

      <Step title="개인 키 및 REST 기본 URI 입력">
        **RSA 개인 키**와 계정의 **REST 기본 URI**(예: `https://na4.docusign.net/restapi`)를 붙여 넣습니다. 기본 URI를 모르는 경우 Docusign 문서에 설명된 대로 **`/oauth/userinfo`** 엔드포인트를 통해 확인하세요.
      </Step>

      <Step title="연결 완료">
        구성을 **제출**합니다(마법사의 레이블에 맞추세요. 공급업체 흐름에서는 이를 **Submit the configuration**이라고 합니다). 연결에 성공하면 마법사에 **연결 구성됨**이 표시됩니다.
      </Step>

      <Step title="소스가 활성인지 확인">
        **Iru가 외부 서비스에 대한 액세스를 요청하고 있습니다** 브라우저 탭을 닫은 다음 **컴플라이언스** → **소스**로 돌아가 **Docusign** 카드가 **활성** 상태인지 확인합니다.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### 문제 해결

<AccordionGroup>
  <Accordion title="소스를 켰을 때 아무것도 열리지 않음">
    Iru 사이트의 **팝업 차단** 설정을 확인한 후 다시 시도하세요.
  </Accordion>

  <Accordion title="consent_required">
    가장에 대한 브라우저 동의를 완료하세요.
  </Accordion>

  <Accordion title="invalid_grant / JWT 오류">
    개인 키가 업로드한 공개 키와 일치하는지, 서버 시계가 정확한지 확인하세요.
  </Accordion>

  <Accordion title="잘못된 기본 URI">
    Docusign 계정 메타데이터에서 리전별 **`restapi`** 호스트를 확인하세요.
  </Accordion>

  <Accordion title="샌드박스와 프로덕션">
    키와 OAuth 호스트가 환경과 일치해야 합니다.
  </Accordion>
</AccordionGroup>

### 고려 사항

<CardGroup cols={2}>
  <Card title="액세스 토큰은 약 1시간마다 만료되며 JWT Grant가 다시…" icon="circle-info">
    액세스 토큰은 약 1시간마다 만료되며 **JWT Grant**가 자동으로 다시 실행됩니다. **RSA 개인 키**는 프로덕션 시크릿처럼 보호하세요.
  </Card>
</CardGroup>

### 관련 문서

<CardGroup cols={2}>
  <Card title="Sources 관리" icon="plug" href="/ko/compliance/sources-management">
    모든 Compliance 소스를 찾아보고 관리합니다.
  </Card>

  <Card title="Compliance 시작하기" icon="rocket" href="/ko/compliance/getting-started-with-compliance">
    프레임워크, 작업 및 **아티팩트**.
  </Card>

  <Card title="Iru 개요" icon="layer-group" href="/ko/iru/platform-overview/iru-overview">
    Endpoint, Compliance 및 Identity가 함께 작동하는 방식.
  </Card>

  <Card title="Artifacts 관리" icon="folder-open" href="/ko/compliance/artifacts-management">
    소스 및 작업에서 수집한 증거를 업로드, 검토 및 정리합니다.
  </Card>
</CardGroup>