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

# Cloudflare

> 범위가 지정된 API 토큰을 사용하여 Cloudflare를 Iru Compliance에 연결하고 영역, DNS 레코드, 보안 설정, WAF 규칙 및 계정 멤버십을 수집합니다.

### Cloudflare 정보

Iru는 **Bearer** 인증으로 전송되는 **범위가 지정된 API 토큰**을 사용하여 Cloudflare API를 통해 **영역(zone)**, **DNS**, **보안 및 WAF 설정**, **방화벽 규칙** 및 **계정** 멤버십을 읽습니다.

### 작동 방식

```http theme={null}
Authorization: Bearer YOUR_API_TOKEN
```

| 세부 정보 | 값 |
| - | - |
| **카테고리** | 보안 |
| **인증** | API 토큰(Bearer) |

장기 자동화에는 **계정 API 토큰**(Manage Account → API Tokens)을 사용하는 것이 좋습니다. **사용자** 토큰은 개별 사용자를 따릅니다.

공식 참고 자료: [토큰 생성](https://developers.cloudflare.com/fundamentals/api/get-started/create-token/), [토큰 제한](https://developers.cloudflare.com/fundamentals/api/how-to/restrict-tokens/), [API](https://developers.cloudflare.com/api/).

### 사전 요구 사항

* Cloudflare 계정의 **관리자** 또는 **Super Administrator**(또는 이에 상응하는) 권한.

### Cloudflare를 Iru에 연결

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

    <Steps>
      <Step title="Cloudflare에 로그인">
        [Cloudflare 대시보드](https://dash.cloudflare.com)를 열고 **관리자** 또는 **Super Administrator** 계정으로 로그인합니다.
      </Step>

      <Step title="계정 수준 또는 사용자 수준 토큰 선택">
        Iru에서 **계정 API 토큰**(**Manage Account** → **API Tokens**)을 사용할지, 프로필에 연결된 **사용자 API 토큰**(**My Profile** → **API Tokens**)을 사용할지 결정합니다. 조직 전체의 증거에는 일반적으로 계정 토큰을 사용하며, 사용자 토큰은 한 운영자의 액세스 권한을 따릅니다.
      </Step>

      <Step title="토큰 생성">
        **Create Token**을 선택합니다. 보안 팀에서 더 좁은 **사용자 지정** 정책을 게시하지 않는 한 **Read all resources**와 같은 **읽기** 템플릿을 사용하는 것이 좋습니다.
      </Step>

      <Step title="읽기 권한 설정">
        **사용자 지정** 토큰을 사용하는 경우 Iru가 프레임워크에 필요로 하는 **계정**, **Zone** 및 **사용자** 객체에 대해 **읽기**(또는 이에 상응하는) 권한을 부여합니다. 정책상 필요하지 않다면 쓰기 권한은 피하세요.
      </Step>

      <Step title="선택적 제한">
        보안 프로그램에서 요구하는 경우 **TTL**(유효 기간) 및 **IP 허용 목록**을 설정합니다. 만료 날짜가 있다면 교체 일정에 기록해 두세요.
      </Step>

      <Step title="토큰 생성 및 복사">
        토큰을 생성하고 Cloudflare에 시크릿이 표시될 때 **한 번만** 복사합니다. 볼트에 보관하세요. 이 값을 Iru에 **Bearer** 토큰으로 붙여 넣게 됩니다.
      </Step>
    </Steps>

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

  <Tab title="Iru Compliance">
    <Note>
      먼저 [**Cloudflare**](#cloudflare) 탭을 완료하세요.
    </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="Cloudflare 켜기">
        **Cloudflare**를 찾습니다(**범주** 또는 **이름 또는 설명으로 검색** 사용). 해당 카드에서 **토글**을 켭니다. 커넥터 마법사용 브라우저 탭 또는 창이 열릴 수 있습니다.
      </Step>

      <Step title="API 토큰 붙여 넣기">
        **Bearer token** 필드에 토큰을 붙여 넣습니다.
      </Step>

      <Step title="연결 완료">
        **Bearer 토큰 제출**을 선택합니다. 연결에 성공하면 마법사에 **연결 구성됨**이 표시됩니다.
      </Step>

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

### 문제 해결

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

  <Accordion title="401 Unauthorized">
    `GET https://api.cloudflare.com/client/v4/user/tokens/verify`로 확인하고 TTL 및 취소 여부를 점검하세요.
  </Accordion>

  <Accordion title="영역 누락">
    토큰 범위 문제입니다. 올바른 계정 및 영역 리소스로 토큰을 다시 생성하세요.
  </Accordion>

  <Accordion title="만료된 토큰">
    TTL을 설정한 경우 만료 전에 토큰을 교체하고 Iru를 업데이트하세요.
  </Accordion>
</AccordionGroup>

### 고려 사항

<CardGroup cols={2}>
  <Card title="Iru는 읽기 권한만 사용하며 변경하지 않습니다…" icon="circle-info">
    Iru는 **읽기** 권한만 사용하며 DNS, 규칙 또는 영역을 변경하지 않습니다.
  </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>