> For the complete documentation index, see [llms.txt](https://docs.panther.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.panther.com/ko/system-configuration/panther-deployment-types/cloud-connected/set-up.md).

# Cloud Connected Panther 인스턴스 설정

## 개요

프로비저닝하려면 [Cloud Connected](/ko/system-configuration/panther-deployment-types/cloud-connected.md) Panther 인스턴스에는 `panther-cloud-connected-setup` CLI 도구를 사용하며, 수동 단계도 추가로 수행해야 합니다. Cloud Connected Panther 인스턴스는 AWS와 Snowflake 또는 Databricks에 배포됩니다.

아래에서 CLI 도구에 대해 읽은 다음 설정 프로세스를 시작하세요.

{% hint style="info" %}
이 페이지의 지침은 *새로운* Cloud Connected 배포를 설정하기 위한 것입니다. 기존 [Panther 호스팅(SaaS)](/ko/system-configuration/panther-deployment-types.md#saas) 인스턴스를 Cloud Connected 배포로 전환하려는 경우에는 이 단계를 따르지 마세요. 대신 Panther 지원팀에 문의하여 전환을 시작하세요.
{% endhint %}

## 다음 `panther-cloud-connected-setup` 도구

Cloud Connected Panther 인스턴스를 설정하는 과정의 일부는 [`panther-cloud-connected-setup` CLI 도구](https://github.com/panther-labs/panther-cli)를 실행하는 것입니다. 이 도구는 로컬 머신 또는 AWS, Snowflake, Databricks 계정 내에서만 모든 작업을 수행하며, 어떤 자격 증명이나 정보도 Panther와 공유하지 않습니다.

### 도구가 수행하는 작업

이 도구를 실행하면:

* AWS 계정 내에서:
  * 다음을 배포합니다. `PantherDeploymentRole` IAM 역할
  * 다음을 설치합니다. `PantherDeploymentUpdaterRole`를 설치하여, `PantherDeploymentRole` 최신 상태로 유지합니다.
  * 다음을 배포하고 실행합니다. `PantherReadinessCheck` 사전 배포 도구, 이를 통해 배포 문제를 겪을 가능성이 낮은지 확인합니다.
  * 제공한 루트 도메인을 기반으로 다음 하위 도메인에 대한 SSL 인증서를 등록합니다:
    * `<원하는 panther 하위 도메인>.yourdomain.com`
    * `*. <원하는 panther 하위 도메인>.yourdomain.com`
  * (선택 사항) 인증서 검증을 위해 Route 53에 DNS 검증 레코드를 생성합니다
* (Snowflake를 사용하는 경우) 다음을 사용하여 AWS 환경에 Snowflake 자격 증명을 프로비저닝합니다:
  * (권장) Panther가 대신 생성하는 Snowflake 계정과 관리자 사용자
  * (권장하지 않음) 이미 생성된(비어 있는) Snowflake 계정과 관리자 사용자를 제공하며, 다음 [지침 아래](#snowflake-prerequisites)에 따라 생성합니다. 이 방법은 `panther-cloud-connected-setup` 도구가 [GLOBALORGADMIN 역할](https://docs.snowflake.com/en/user-guide/organization-administrators#label-org-admins-globalorgadmin)을 가진 Snowflake 사용자를 사용하도록 허용할 수 없는 경우에 적합할 수 있습니다. (이 사용자의 자격 증명은 Panther와 절대 공유되지 않습니다.)

{% hint style="info" %}
Databricks를 데이터 저장소로 사용하는 경우, CLI 도구는 Databricks에서 어떤 작업도 수행하지 않습니다.
{% endhint %}

### 도구가 상태를 저장하는 방법

다음 `panther-cloud-connected-setup` 도구는 상태를 `panther-cli-state.db` 파일에 저장합니다. 도구가 첫 실행에서 Panther 인스턴스를 성공적으로 프로비저닝하지 못하더라도, 이 파일은 이미 성공적으로 완료된 단계를 추적하므로 재실행을 더 쉽게 해줍니다.

{% hint style="warning" %}
이 파일에는 민감한 정보가 저장됩니다. Panther 인스턴스를 성공적으로 프로비저닝한 후에는 `./panther-cloud-connected-setup --clean` 을 실행하여 파일을 삭제하거나, 디스크에서 파일을 직접 삭제하는 것이 좋습니다.
{% endhint %}

## Cloud Connected Panther 인스턴스 설정 방법

### 사전 요구 사항

#### 도구 설치 사전 요구 사항

시작하기 전에 먼저 `panther-cloud-connected-setup` 도구.

<table><thead><tr><th width="185.42364501953125">운영 체제</th><th>설치 지침</th></tr></thead><tbody><tr><td>macOS 및 Linux</td><td><p>다음을 사용하여 <code>panther-cloud-connected-setup</code> 도구를 <a href="https://brew.sh/">Homebrew</a> 로 설치하려면 다음 명령을 실행하세요:</p><pre class="language-bash"><code class="lang-bash">brew tap panther-labs/tap https://github.com/panther-labs/homebrew-taps.git
brew install panther-labs/tap/panther-cloud-connected-setup
</code></pre><p>첫 번째 명령은 Panther의 <a href="https://github.com/panther-labs/homebrew-taps">Homebrew tap용 자체 GitHub 저장소를 참조합니다</a>.</p></td></tr><tr><td>Windows</td><td>다음을 사용하여 <code>panther-cloud-connected-setup</code> 다음 저장소의 패키지를 사용하여 도구를 <a href="https://github.com/panther-labs/panther-cli/releases"><code>panther-cli</code> 저장소의 Releases 페이지</a>.</td></tr></tbody></table>

도구가 올바르게 설정되었는지 확인하려면 다음을 실행하세요:

```bash
panther-cloud-connected-setup --clean
```

이 명령은 다음과 비슷한 출력을 생성해야 합니다:

```
~ ❯❯❯ panther-cloud-connected-setup --clean                                                                                          ✘ 255
2025/06/17 12:46:38 상태를 성공적으로 정리했습니다
~ ❯❯❯
```

#### AWS 사전 요구 사항

* 하나의 [AWS 조직](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_introduction.html).
* 다음 중 하나를 사용하여 AWS에 인증할 수 있어야 합니다( [아래에 설명된 방법](#authenticating-with-aws)) 다음 중 하나를 사용하여:
  * (권장) AWS 계정 [루트 사용자](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html) (또는 비슷한 권한을 가진 다른 IAM 사용자).
  * 다음과 같은 권한 이상을 가진 IAM 사용자:
    * 다음을 배포할 수 있는 능력 [CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html) 템플릿
    * 다음에서 인증서를 생성할 수 있는 능력 [AWS Certificate Manager(ACM)](https://docs.aws.amazon.com/acm/latest/userguide/acm-overview.html)
    * 다음을 생성하고 호출할 수 있는 능력 [Lambda](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html)
    * 다음에 대해 읽고/쓸 수 있는 능력 [Secrets Manager](https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html)

{% hint style="info" %}
AWS 조직에 [서비스 제어 정책(SCP)](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scps.html) 및 [Control Tower 가드레일](https://docs.aws.amazon.com/audit-manager/latest/userguide/controltower.html) 이 조직 수준에 적용되어 있다면, 이를 업데이트하거나 예외를 생성할 수 있는 능력이 있는 것이 좋습니다. 이러한 정책은 CLI 도구의 작업을 방해하여 프로비저닝이 성공하지 못하게 할 수 있습니다.
{% endhint %}

<details>

<summary>AWS 인증</summary>

다음 `panther-cloud-connected-setup` 도구는 다음 두 가지를 모두 사용한 AWS 인증을 지원합니다:

* 명시적으로 정의된 AWS [액세스 키 ID와 비밀 액세스 키](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) (그리고 선택적으로 [세션 토큰](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html))을 `config.yml` 파일에 넣는 방법
* 표준 환경 설정(즉, 환경 변수 또는 `~/.aws/config` 파일)

AWS 인증을 시도할 때, 도구는 먼저 `config.yml` 파일에서 명시적으로 정의된 자격 증명(`AWSConfig.AccessKeyID` 및 `AWSConfig.SecretAccessKey`).

을 찾습니다. 자격 증명이 `config.yml`에서 발견되면, 해당 자격 증명을 사용하여 인증합니다. 자격 증명이 `config.yml`에서 발견되지 않으면, 모든 AWS 클라이언트 라이브러리의 표준 해결 전략을 사용하여 환경에서 AWS 자격 증명을 로드하려고 시도합니다.

</details>

#### 기타 사전 요구 사항

* 사용자 지정 도메인이 등록되어 있어야 합니다.
  * 사용자 지정 도메인 등록에 도움이 필요하고 도메인 등록 기관으로 AWS를 사용하려면 다음을 따르세요. [이 Amazon Route 53 문서](https://aws.amazon.com/getting-started/hands-on/get-a-domain/).

#### (Snowflake를 사용하는 경우) Snowflake 사전 요구 사항

* 다음이 있어야 합니다. [Snowflake 조직](https://docs.snowflake.com/en/user-guide/organizations).
* (도구가 Snowflake 계정과 관리자 사용자를 대신 프로비저닝하도록 하려면, 이는 권장 사항입니다) 다음을 만족하는 Snowflake 사용자가 있어야 합니다: `panther-cloud-connected-setup` 다음을 가지고 있어야 합니다.
  * 이 연결된 [GLOBALORGADMIN 역할](https://docs.snowflake.com/en/user-guide/organization-administrators#label-org-admins-globalorgadmin) Snowflake 문서는 ORGADMIN 역할이 제거될 예정이라고 명시합니다
    * 다음 [Snowflake 문서에서는 ORGADMIN 역할이 제거될 예정이라고 설명합니다](https://docs.snowflake.com/en/user-guide/organization-administrators#using-the-orgadmin-role). 그 전까지는 GLOBALORGADMIN 대신 ORGADMIN 역할을 가진 사용자를 사용할 수 있습니다.
  * RSA 키 쌍 인증을 사용합니다. RSA 키 쌍을 설정해야 하는 경우 다음을 따르세요. [Snowflake 키 쌍 인증 구성 지침](https://docs.snowflake.com/en/user-guide/key-pair-auth#configuring-key-pair-authentication).
  * 다음 값이 일치해야 합니다. `NAME` 및 `LOGIN_NAME`. 이를 확인하려면 Snowflake 워크시트에서 다음 명령을 실행하세요. [Snowflake 워크시트](https://docs.snowflake.com/en/user-guide/ui-snowsight-worksheets-gs):

    ```sql
    DESC USER <your user>; -- 여기에서 사용자 이름을 업데이트하세요
    SELECT "property", "value"
        FROM TABLE(RESULT_SCAN(LAST_QUERY_ID()))
        WHERE "property" = 'NAME' OR "property" = 'LOGIN_NAME';
        
    ```
* (이미 생성된 Snowflake 계정과 관리자 사용자를 제공할 예정인 경우, 이는 권장되지 않습니다) 아래 지침에 따라 생성된 비어 있는 Snowflake 계정과 관리자 사용자가 있어야 합니다.
  * 일부 Panther 기능에는 [Snowflake Enterprise](https://docs.snowflake.com/en/user-guide/intro-editions) 이상입니다. [여기서 자세히 알아보세요](/ko/search/backend/snowflake/configuration.md#panther-features-requiring-snowflake-enterprise-or-higher).

<details>

<summary>(권장하지 않음) Panther용 새 Snowflake 계정과 사용자를 수동으로 생성</summary>

{% hint style="warning" %}
대신 panther-cloud-connected-setup 도구가 Snowflake 계정과 사용자를 대신 프로비저닝하도록 하는 것이 좋습니다.
{% endhint %}

Snowflake 계정과 사용자를 수동으로 생성하려면:

1. Snowflake 조직에서 아래 템플릿을 사용하여 Panther용 새 전용 Snowflake 계정을 생성하세요. `<YOUR_REGION>` 다음 중 하나여야 합니다. [지원되는 AWS 리전](/ko/system-configuration/panther-deployment-types.md#supported-aws-regions) (그리고 Panther 인스턴스가 결국 배포될 동일한 AWS [리전](https://docs.snowflake.com/en/user-guide/intro-regions) 이어야 합니다).\
   \
   이 명령은 [계정을 생성하며](https://docs.snowflake.com/en/user-guide/organizations-manage-accounts-create) 계정의 첫 번째 사용자도 생성하는데, 이 사용자에게는 `ACCOUNTADMIN` 역할 `권한이 부여됩니다. 이 사용자는 Panther에 제공되지 않습니다. 전체 구문 지침은 다음을 참조하세요.` 명령 [여기](https://docs.snowflake.com/en/sql-reference/sql/create-account).

   ```sql
   CREATE ACCOUNT

   CREATE ACCOUNT <YOUR_PANTHER_ACCOUNT_NAME> // 원하는 Panther 계정 이름
     ADMIN_NAME = <YOUR_ADMIN_NAME> // 'pantheraccountadmin'이 아닌 다른 이름이어야 합니다
     ADMIN_USER_TYPE = PERSON 
     ADMIN_PASSWORD = '<string_literal>'
     EMAIL = '<your snowflake DBA email>'
     MUST_CHANGE_PASSWORD = FALSE
     EDITION = <YOUR_EDITION> // STANDARD, ENTERPRISE 또는 BUSINESS_CRITICAL
     REGION = <YOUR_REGION> // Panther 인스턴스가 결국 배포될 AWS 리전
     COMMENT =  'Panther Snowflake Cloud Connected Production Environment'; 
   ```
2. 다음 명령으로 Snowflake 계정 URL을 구성하세요:

   ```sql
   SELECT LOWER(CURRENT_ORGANIZATION_NAME() 
   || '-' || CURRENT_ACCOUNT_NAME() 
   || '.snowflakecomputing.com') AS account_url;
   ```

   * URL은 다음 형식이 됩니다: `<org-name>-<account-name>.snowflakecomputing.com`
   * 이 값을 안전한 위치에 저장하세요. 이 프로세스의 나중 단계에서 필요합니다.
3. 다음 명령으로 RSA 키 쌍을 생성하세요:\
   `openssl genrsa 4096 | openssl pkcs8 -topk8 -inform PEM -out panther_rsa_key.p8 -nocrypt && openssl rsa -in panther_rsa_key.p8 -pubout -out panther_rsa_key.pub`
   * 추가 안내는 다음을 참조하세요. [Snowflake의 키 쌍 인증 구성 문서](https://docs.snowflake.com/en/user-guide/key-pair-auth#configuring-key-pair-authentication).
4. 1단계에서 생성한 관리자 사용자에게 RSA 공개 키를 할당하세요:

   ```sql
   ALTER USER <YOUR_ADMIN_NAME> SET RSA_PUBLIC_KEY='...';
   ```

</details>

#### (Databricks를 사용하는 경우) Databricks 사전 요구 사항

* 다음을 참조하세요 [사전 요구 사항](/ko/system-configuration/panther-deployment-types/cloud-connected/databricks.md#prerequisites) 에서 [Panther용 Databricks 구성](/ko/system-configuration/panther-deployment-types/cloud-connected/databricks.md).

### 1단계: 새 AWS 계정 생성

* AWS 조직에서 [새 계정을 생성하세요](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_accounts_create.html)필요한 경우. (기존의 비어 있는 계정을 사용하는 것도 가능합니다.)

{% hint style="warning" %}
Panther 인스턴스는 기존 리소스가 있는 AWS 계정에 배포할 수 없습니다.
{% endhint %}

### 2단계: Panther에 값 요청

{% hint style="info" %}
이 단계는 Panther Cloud Connected 인스턴스를 처음 설정하는 경우에만 필요합니다. 이전에 이미 수행한 적이 있다면(예: 여러 Panther 인스턴스를 관리하는 경우), 값은 변경되지 않으므로 이전 값을 사용할 수 있습니다.
{% endhint %}

* Panther 지원팀에 연락하여 Cloud Connected 인스턴스를 배포 중임을 알리고 다음 값에 대해 요청하세요. `CloudFormationConfig.IdentityAccountId` 및 `CloudFormationConfig.OpsAccountId`. 이 값들은 3단계에서 사용합니다.

### 3단계: 구성 파일 작성

1. 다음 템플릿 중 하나를 복사하여 로컬에 구성 파일을 만드세요:
   * Snowflake를 사용하는 경우:
     * 도구가 `panther-cloud-connected-setup` Snowflake 계정과 관리자 사용자를 대신 프로비저닝해야 하는 경우: [example-config-new-snowflake-acct.yml](https://github.com/panther-labs/panther-cli/blob/main/example-config-new-snowflake-acct.yml)
     * 이미 생성된 비어 있는 Snowflake 계정과 관리자 사용자를 제공할 경우: [example-config-existing-snowflake-acct.yml](https://github.com/panther-labs/panther-cli/blob/main/example-config-existing-snowflake-acct.yml)
   * Databricks를 사용하는 경우: [example-config-databricks.yml](https://github.com/panther-labs/panther-cli/blob/main/example-config-databricks.yml)
2. 템플릿의 지침을 따르면서 아래 사항에 유의하여 키의 값을 업데이트하세요:
   * 값을 입력할 때 `PantherAccountConfig.Region`중 하나를 사용하세요. [지원되는 AWS Panther 리전](/ko/system-configuration/panther-deployment-types.md#supported-aws-regions). 이 리전은 Panther 인스턴스가 배포될 위치입니다.
   * (사용 중인 경우 [example-config-new-snowflake-acct.yml](https://github.com/panther-labs/panther-cli/blob/main/example-config-new-snowflake-acct.yml)) 값을 입력할 때 `SnowflakeConfig.NewAccountConfig.SnowflakeEdition`에 유의하세요. 일부 Panther 기능에는 [Snowflake Enterprise](https://docs.snowflake.com/en/user-guide/intro-editions) 이상입니다. [여기서 자세히 알아보세요](https://docs.panther.com/system-configuration/panther-deployment-types/cloud-connected/snowflake#panther-features-requiring-snowflake-enterprise-or-higher).
   * 다음 `AutoRegisterValidationDomains` 필드는 도구가 필요한 인증서를 발급하기 위해 대신 DNS 레코드를 생성할 수 있게 해줍니다. 이를 `true` 로 설정하면 Panther 배포에 사용되는 AWS 계정이 Panther 도메인의 DNS 레코드도 함께 관리해야 합니다.

### 4단계: `panther-cloud-connected-setup` 도구

* 다음 명령으로 도구를 실행하세요:

  ```
  ./panther-cloud-connected-setup --config-file config.yml
  ```

  * 유용할 수 있는 추가 플래그:
    * `--verbose`: 상세 로그 출력
    * `--snowflake-logging`: 상세 Snowflake 로그 출력
    * `--force-check-certificates`: 이미 발급됨으로 표시되어 있어도 인증서를 강제로 확인

{% hint style="info" %}
도구에 대해 자세히 알아보려면 [README.md](https://github.com/panther-labs/panther-cli/blob/main/README.md).
{% endhint %}

### 5단계(필요한 경우): 인증서 요청을 검증하기 위한 DNS 레코드 생성

이전 단계에서 `panther-cloud-connected-setup` 도구를 `AutoRegisterValidationDomains: true` 를 [구성 파일](#step-3-fill-out-the-configuration-file)에 설정했다면, Route 53에 DNS 검증 레코드가 생성됩니다.

AutoRegisterValidationDomains: false `를 설정했다면`, DNS 검증 레코드를 [수동으로 생성해야 합니다](#manual-dns-record-creation).

#### **자동 DNS 레코드 생성(활성화된 경우)**

AutoRegisterValidationDomains: false `AutoRegisterValidationDomains: true` 를 [구성 파일](#step-3-fill-out-the-configuration-file) 그리고 도메인이 동일한 AWS 계정의 Route 53에 호스팅되어 있다면, `panther-cloud-connected-setup` 를 실행하면 필요한 DNS 검증 레코드를 자동으로 생성하려고 시도합니다.

도구 출력에서 확인하세요:

* 다음이 보이면 `DNS 검증 레코드가 성공적으로 생성되었습니다` 메시지가 표시되면 DNS 레코드가 자동으로 생성된 것이므로 아래의 수동 단계를 건너뛸 수 있습니다.
* 다음이 보이면 `검증 도메인 자동 등록 실패` 경고가 표시되거나 인증서가 발급되지 않은 것으로 표시되면 아래의 수동 단계를 진행하세요.

#### **수동 DNS 레코드 생성**

AutoRegisterValidationDomains: false `를 설정했다면` 를 [구성 파일](#step-3-fill-out-the-configuration-file) 또는 자동 등록이 실패한 경우, DNS 검증 레코드를 수동으로 생성하세요:

1. 도구를 성공적으로 실행하면 계정 정보가 포함된 파일이 출력됩니다. 이 파일에서 `panther_certificate` 및 `wildcard_certificate` 노드를 찾으세요:

   ```json
     "panther_certificate": {
       "certificate_arn": "arn:aws:acm:us-west-2:123456789012:certificate/ad41e5b1-0681-444d-85a9-10edc4619cd2",
       "validation_details": {
         "domain_name": "panther.coolsystems.net",
         "record_name": "_8f65a0a68b4ca63ae9b9baa41429bf89.panther.coolsystems.net.",
         "record_value": "_2b5df93054bace85f6a84fb07235830d.zfyfvmchrl.acm-validations.aws.",
         "record_type": "CNAME"
       },
       "is_issued": false
     },
     "wildcard_certificate": {
       "certificate_arn": "arn:aws:acm:us-east-1:123456789012:certificate/5b14c5f3-867b-4420-a990-4621da85e973",
       "validation_details": {
         "domain_name": "*.panther.coolsystems.net",
         "record_name": "_8f65a0a68b4ca63ae9b9baa41429bf89.panther.coolsystems.net.",
         "record_value": "_2b5df93054bace85f6a84fb07235830d.zfyfvmchrl.acm-validations.aws.",
         "record_type": "CNAME"
       },
       "is_issued": false
     },
   ```

   * 다음 중 `validation_details.record_name` 및 `validation_details.record_value` 값이 `panther_certificate` 및 `wildcard_certificate` 노드 사이에 다른지, 아니면 동일한지 확인하세요.
2. AWS Route53(또는 선호하는 다른 DNS 서비스)에서:
   * 도구가 `validation_details.record_name` 및 `validation_details.record_value` 값이 `panther_certificate` 및 `wildcard_certificate` 노드에서 동일하면 CNAME DNS 레코드 하나를 생성합니다.
     * 위의 예시 출력 파일에서는 값이 동일하므로, 다음과 같이 DNS 레코드 하나만 생성하면 됩니다:
       * 이름: `_8f65a0a68b4ca63ae9b9baa41429bf89.panther.coolsystems.net.`
       * Value: `_2b5df93054bace85f6a84fb07235830d.zfyfvmchrl.acm-validations.aws.`
       * 유형: `CNAME`
   * 도구가 `validation_details.record_name` 및 `validation_details.record_value` 값이 `panther_certificate` 및 `wildcard_certificate` 노드에서 CNAME DNS 레코드 두 개를 생성합니다.

### 6단계: 출력된 파일을 Panther에 제공

* 도구를 성공적으로 실행하면 계정 정보가 포함된 파일이 출력됩니다. 이 파일을 Panther 지원팀에 제공하세요.

<details>

<summary>예시 출력 파일</summary>

```json
{
  "desired_panther_account_name": "Zac's Cool Panther Account",
  "panther_subdomain": "panther.coolsystems.net",
  "panther_edition": "ENTERPRISE",
  "panther_region": "us-west-2",
  "datalake_type": "snowflake",
  "admin_user_first_name": "Zac",
  "admin_user_last_name": "Brown",
  "admin_email": "zac.brown@panther.com",
  "snowflake_secret_arn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:panther-managed-accountadmin-secret-ok3dFA",
  "snowflake_account_name": "pantherlabs-zbrown_cc_provisioning_test81",
  "snowflake_account_url": "https://pantherlabs-zbrown_cc_provisioning_test81.snowflakecomputing.com",
  "snowflake_edition": "ENTERPRISE",
  "aws_account_id": "123456789012",
  "panther_certificate": {
    "certificate_arn": "arn:aws:acm:us-west-2:123456789012:certificate/ad41e5b1-0681-444d-85a9-10edc4619cd2",
    "validation_details": {
      "domain_name": "panther.coolsystems.net",
      "record_name": "_8f65a0a68b4ca63ae9b9baa41429bf89.panther.coolsystems.net.",
      "record_value": "_2b5df93054bace85f6a84fb07235830d.zfyfvmchrl.acm-validations.aws.",
      "record_type": "CNAME"
    },
    "is_issued": false
  },
  "wildcard_certificate": {
    "certificate_arn": "arn:aws:acm:us-east-1:123456789012:certificate/5b14c5f3-867b-4420-a990-4621da85e973",
    "validation_details": {
      "domain_name": "*.panther.coolsystems.net",
      "record_name": "_8f65a0a68b4ca63ae9b9baa41429bf89.panther.coolsystems.net.",
      "record_value": "_2b5df93054bace85f6a84fb07235830d.zfyfvmchrl.acm-validations.aws.",
      "record_type": "CNAME"
    },
    "is_issued": false
  },
  "deployment_status": {
    "aws_bootstrap_tools_deployed": true,
    "aws_deployment_role_deployed": true,
    "aws_readiness_check_succeeded": true,
    "aws_snowflake_bootstrap_succeeded": true
  }
}
```

</details>

{% hint style="warning" %}
여기서 멈추고 Panther가 계속 진행해도 된다고 알릴 때까지 기다리세요.
{% endhint %}

### 7단계: CNAME 레코드 생성

1. AWS 콘솔에서 EC2 서비스로 이동하세요.
2. AWS가 제공한 DNS 이름을 찾으세요. `웹` 로드 밸런서:

   <figure><img src="/files/8269b5cfc8a8109fba660ca632b27de387b35628" alt=""><figcaption></figcaption></figure>

   1. Route53(또는 선호하는 다른 DNS 서비스)로 이동하세요.
   2. 주 하위 도메인(`<원하는_Panther_하위도메인>.<회사이름>.com`)를 이 DNS 이름으로 `웹` 로드 밸런서.
3. EC2에서 AWS가 제공한 DNS 이름을 찾습니다. `http-ingest-alb` 로드 밸런서:

   <figure><img src="/files/c7eba29e0ecfddf83fb2a9fb016f703cac8d695e" alt=""><figcaption></figcaption></figure>

   1. Route53(또는 선호하는 다른 DNS 서비스)로 이동하세요.
   2. 로그 서브도메인(`logs.<your_desired_Panther_subdomain>.<company_name>.com`)를 이 DNS 이름으로 `http-ingest-alb` 로드 밸런서.
4. AWS 콘솔에서 API Gateway 서비스로 이동합니다.
5. 다음을 클릭합니다 **API** > **사용자 지정 도메인 이름**.
6. API 서브도메인(`api.<your_desired_Panther_subdomain>.<company_name>.com`).
7. 다음 **엔드포인트 구성** 섹션에서 다음을 복사합니다. **API Gateway 도메인 이름** 값.\
   ![Under an "Endpoint configuration" header, a field titled "API Gateway domain name" is circled.](/files/7b3d4f37a13a2b050ae9f45e5bd26578a17c1321)
   1. Route53(또는 선호하는 다른 DNS 서비스)로 이동하세요.
   2. API 서브도메인(`api.<your_desired_Panther_subdomain>.<company_name>.com`)를 이 도메인 이름으로 **API Gateway 도메인 이름** 값.
8. (선택 사항) 방금 생성한 세 개의 CNAME 레코드를 검증합니다:
   * 기본 엔드포인트가 작동하는지 확인하려면:
     1. 웹 브라우저에서 기본 서브도메인으로 이동합니다.
     2. Panther Console에 로그인합니다.
   * HTTP 수집 엔드포인트가 작동하는지 확인하려면:
     * [다음 지침에 따라 Panther에서 HTTP Source를 설정합니다](/ko/data-onboarding/data-transports/http.md#how-to-set-up-an-http-log-source-in-panther).
   * API 엔드포인트가 작동하는지 확인하려면, 다음을 사용하여 호출하세요 [Panther Analysis Tool (PAT)](/ko/panther/detections-repo/pat.md):
     1. [API 토큰을 생성합니다](/ko/panther/api.md#how-to-create-a-panther-api-token).
     2. [GraphQL API 엔드포인트를 확인합니다](/ko/panther/api/graphql.md#step-1-identify-your-panther-graphql-api-url).
     3. 다음을 실행합니다 `check-connection` 명령:\
        `pipenv run panther_analysis_tool check-connection --api-host $YOUR_GRAPHQL_ENDPOINT --api-token $YOUR_TOKEN`

### 8단계: API Gateway 및 CodeBuild 할당량 증설 요청

* 다음을 따르세요. [이 AWS 문서](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html) 다음 할당량 증가를 요청하려면:
  * [API Gateway 제한 할당량](https://docs.aws.amazon.com/apigateway/latest/developerguide/limits.html#apigateway-account-level-limits-table): 20,000으로 설정
  * [CodeBuild](https://docs.aws.amazon.com/codebuild/latest/userguide/limits.html):
    * ARM/Large 환경에서 동시에 실행되는 빌드(또는 `ARM BUILD_GENERAL1_LARGE`): 2 이상으로 설정
    * Linux/Large 환경에서 동시에 실행되는 빌드(또는 `Linux BUILD_GENERAL1_LARGE`): 2 이상으로 설정

Panther는 자동으로 다음에 대한 요청을 제출합니다 [Lambda 동시 실행 할당량](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#compute-and-storage) 를 2,000으로 늘리기 위해.

### 9단계(Databricks를 사용하는 경우): Panther용 Databricks 구성

{% hint style="info" %}
Databricks를 사용하는 경우, 이 단계에서 Panther 콘솔에 액세스할 수 있지만 완전히 작동하지는 않습니다.
{% endhint %}

* 다음의 모든 지침을 완료하세요 [Panther용 Databricks 구성](/ko/system-configuration/panther-deployment-types/cloud-connected/databricks.md).

## 사후 설정 권장 사항

### 1단계(권장): AWS 리소스에서 Panther 정의 태그 활성화

* Panther [이 태그들을 정의합니다](/ko/system-configuration/panther-deployment-types/cloud-connected.md#panther-defined-tags-on-aws-resources) Panther 배포를 위해 생성된 AWS 리소스에. 다음을 따르세요 [이 AWS 문서](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/activating-tags.html) 이 태그를 활성화하려면.

### 2단계(선택 사항): AWS 리소스에 사용할 사용자 지정 태그를 Panther에 제공

* Panther 정의 태그 외에도, 다음을 추가하고 싶을 수 있습니다 [고유한 사용자 지정 태그](/ko/system-configuration/panther-deployment-types/cloud-connected.md#custom-tags-on-aws-resources) Panther 배포를 위해 생성된 AWS 리소스에 적용합니다. 이를 위해 태그 키와 값 목록과 함께 Panther 지원 팀에 문의하세요.

### 3단계(Snowflake를 사용하는 경우): 최적의 쿼리 성능을 위한 Snowflake 구성 권장 사항 검토

* 참고 [최적의 검색 성능을 위한 Snowflake 구성](/ko/search/backend/snowflake/configuration.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.panther.com/ko/system-configuration/panther-deployment-types/cloud-connected/set-up.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
