> ## 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.

# Jira

> OAuth로 Jira Cloud를 Iru Compliance에 연결하여 감사를 위한 프로젝트, 이슈, 워크플로, 변경 티켓 및 Jira Service Management 요청 증거를 수집합니다.

### Jira 정보

**Jira** 소스는 **Jira Cloud**에서 **프로젝트 구성**, **이슈 메타데이터**, **워크플로 정의**, **사용자 및 담당자 정보**, **Jira Service Management** 요청 데이터를 Iru Compliance로 가져오며, 이 데이터는 작업 및 컨트롤에 연결할 수 있는 증거가 됩니다. Iru는 **Atlassian의 3-legged OAuth 2.0(3LO)** authorization code 흐름을 통해 연결합니다. 통합은 **읽기 전용**입니다. Iru는 이슈, 프로젝트 또는 워크스페이스 설정을 생성하거나 변경하지 않습니다.

이 커넥터는 **Jira Cloud** 전용입니다. **Jira Data Center**(자체 호스팅)는 다른 인증 모델을 사용하며 이 소스에서 지원되지 **않습니다**.

### 작동 방식

**Cloud ID**를 제공하면 커넥터 마법사가 Atlassian으로 이동하여 로그인하고 동의하도록 합니다. Iru는 수명이 짧은 **액세스 토큰**과 **순환 새로 고침 토큰**을 받으며, 동기화 주기마다 토큰을 자동으로 갱신합니다.

| 범위 | 허용 항목 |
| - | - |
| `read:jira-work` | 이슈, 프로젝트, 워크플로 및 첨부 파일 읽기 |
| `read:jira-user` | 사용자 프로필 및 담당자 정보 읽기 |
| `read:jira-service-desk` | Jira Service Management 요청 및 SLA 지표 읽기 |

| 항목 | 값 |
| - | - |
| **범주** | 프로젝트 관리 |
| **인증** | OAuth 2.0(Jira Cloud 3LO) |
| **공급업체 요금제** | **유료** Jira Cloud 요금제(**Free** 등급은 이 커넥터에 필요한 OAuth API 액세스를 지원하지 않음) |

문서 허브: [Atlassian Support - Jira](https://support.atlassian.com/jira/). OAuth: [Jira Cloud OAuth 2.0 (3LO)](https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/), [OAuth 2.0 scopes](https://developer.atlassian.com/cloud/jira/platform/scopes-for-oauth-2-3LO-and-forge-apps/). Cloud ID: [Retrieve your Atlassian Cloud ID](https://support.atlassian.com/jira/kb/retrieve-my-atlassian-sites-cloud-id/).

### 사전 요구 사항

* **유료** Jira Cloud 사이트(**Free**는 여기에 필요한 OAuth API 액세스를 지원하지 않음).
* **Jira Cloud ID**(UUID). 아래의 **Jira Cloud ID 찾기**를 참조하세요.
* OAuth 단계가 열릴 수 있도록 **Iru** 도메인에 대해 브라우저 **팝업** 허용.
* 로그인하는 사용자가 Jira 관리자일 필요는 **없지만**, Iru는 해당 사용자가 액세스할 수 있는 데이터만 읽을 수 있습니다. 광범위한 증거 수집을 위해서는 최소한 다음 권한을 가진 계정을 사용하세요.
  * Iru가 읽을 모든 프로젝트에 대한 **Browse projects**.
  * 사용자 및 담당자 메타데이터가 필요한 경우 **Browse users and groups**(전역 권한).

적절한 프로젝트 전반에 읽기 액세스 권한을 가진 **전용 서비스 계정**을 사용하는 것이 범위를 안정적으로 유지하는 가장 쉬운 방법인 경우가 많습니다.

### Jira를 Iru에 연결

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

    #### Jira Cloud ID 찾기

    **Cloud ID**는 Iru가 `https://api.atlassian.com/ex/jira/{cloudId}`와 함께 사용하는 UUID입니다.

    <Steps>
      <Step title="Jira Cloud 및 유료 액세스 확인">
        이 커넥터는 Iru에 필요한 OAuth API 액세스를 허용하는 **유료** 요금제의 **Jira Cloud**를 지원합니다. 통합을 차단하는 **Free** 사이트가 아닌지 확인하세요.
      </Step>

      <Step title="Jira 사이트 열기">
        브라우저에서 Jira Cloud URL(예: `https://yoursite.atlassian.net`)을 열어 아래 단계에서 대체할 **하위 도메인**을 확인합니다.
      </Step>

      <Step title="Cloud ID 조회 방법 선택">
        빠른 JSON 조회를 원하면 **옵션 A**를, 이미 **Atlassian Admin**을 사용하고 있다면 **옵션 B**를 사용하세요.
      </Step>

      <Step title="옵션 A: Tenant info(가장 빠름)">
        새 브라우저 탭에서 다음을 엽니다(`yoursite`를 Jira 하위 도메인으로 바꾸세요).

        `https://yoursite.atlassian.net/_edge/tenant_info`

        JSON 응답에서 **`cloudId`** 값을 복사합니다.
      </Step>

      <Step title="옵션 B: Atlassian Admin">
        [admin.atlassian.com](https://admin.atlassian.com)에 로그인하고 조직을 선택한 다음 브라우저 URL에서 Cloud ID를 찾습니다(`/s/` 뒤에 표시됨).
      </Step>

      <Step title="Iru용 Cloud ID 저장">
        [**Iru Compliance**](#iru-compliance) 탭에서 Iru 커넥터 마법사의 **cloudId** 필드에 붙여넣을 때까지 UUID를 안전한 곳에 보관합니다.
      </Step>
    </Steps>

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

  <Tab title="Iru Compliance">
    <Note>
      커넥터 마법사에 사용할 **Cloud ID**를 확보할 수 있도록 먼저 [**Jira**](#jira) 탭을 완료하세요.
    </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="Jira 켜기">
        **Jira**를 찾습니다(**범주**를 **Project management**로 설정하거나 **이름 또는 설명으로 검색** 사용). 해당 카드에서 **토글**을 켭니다. 브라우저 탭에서 커넥터 마법사가 열립니다.
      </Step>

      <Step title="1/2단계: 서버 변수 구성">
        **cloudId** 필드에 **Cloud ID**를 입력한 다음 **Configure Server Variables**를 선택합니다. 계속하기 전에 서버 변수가 성공적으로 업데이트되었다는 확인을 기다립니다.
      </Step>

      <Step title="2/2단계: OAuth">
        **Launch OAuth Authentication**을 선택합니다. Atlassian 팝업이 열리면 로그인하고 **Accept**를 선택하여 요청된 권한을 부여합니다.
      </Step>

      <Step title="연결 완료">
        팝업이 닫히면 Iru가 OAuth 교환을 완료합니다. 연결에 성공하면 마법사에 **연결 구성됨**이 표시됩니다.
      </Step>

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

### 문제 해결

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

  <Accordion title="서버 변수 업데이트 실패">
    마법사 링크가 만료되었을 수 있습니다. **소스**에서 **Jira**를 껐다가 다시 켠 다음 **Cloud ID**를 다시 입력하세요.
  </Accordion>

  <Accordion title="프로젝트 또는 이슈 누락">
    OAuth를 완료한 계정에 일부 스페이스에 대한 **Browse projects** 권한이 없을 수 있습니다. Jira 권한을 조정하거나 필요한 읽기 범위를 가진 **서비스 계정**으로 연결하세요.
  </Accordion>

  <Accordion title="토큰 만료 또는 재연결 메시지">
    Jira Cloud는 유효 기간이 **90일**인 **순환 새로 고침 토큰**을 사용합니다. 연결이 그보다 오래 유휴 상태이면 **Jira** 소스 카드에서 OAuth 흐름을 다시 완료하세요.
  </Accordion>

  <Accordion title="Jira Free 요금제">
    **Free** 등급은 이 커넥터에 필요한 OAuth API 액세스를 지원하지 않습니다. 연결하려면 **유료** Jira Cloud 요금제를 사용하세요.
  </Accordion>

  <Accordion title="잘못된 사이트 또는 잘못된 Cloud ID">
    **Cloud ID**가 의도한 사이트와 일치하는지 확인하세요(**Jira Cloud ID 찾기** 참조). 일치하지 않으면 Iru가 잘못된 테넌트를 가리킵니다.
  </Accordion>
</AccordionGroup>

### 고려 사항

<CardGroup cols={2}>
  <Card title="새로 고침 토큰 및 유휴 연결" icon="circle-info">
    Iru는 동기화 주기마다 액세스 토큰을 새로 고칩니다. **90일** 동안 동기화가 실행되지 않으면 소스 카드를 통해 **다시 인증**해야 합니다.
  </Card>

  <Card title="대규모 프로젝트 및 보존" icon="shield">
    대규모 프로젝트는 방대한 기록을 생성합니다. 가능한 경우 프로젝트 범위를 좁히고, 감사에서 워크플로 증거에 의존하기 전에 **보존** 및 **개인정보 보호** 정책을 조정하세요.
  </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>