인증서 관리

콘솔

1. Google Cloud 콘솔에서 인증서 관리자 페이지로 이동합니다.

   인증서 관리자로 이동

2. 표시되는 페이지에서 인증서 탭을 선택합니다.

3. 인증서 추가를 클릭합니다.

4. 인증서 이름을 입력합니다.

   이 이름은 프로젝트에서 고유해야 합니다.

5. (선택사항) 인증서의 설명을 입력합니다. 설명은 나중에 특정 인증서를 식별하는 데 도움이 됩니다.

6. 위치에 전역을 선택합니다.

7. 범위에서 기본값을 선택합니다.

8. 인증서 유형에서 Google 관리형 인증서 만들기를 선택합니다.

9. 인증 기관 유형에서 공개를 선택합니다.

10. 인증서의 도메인 이름을 지정합니다. 쉼표로 구분된 대상 도메인의 목록을 입력합니다. 또한 각 도메인 이름은 myorg.example.com과 같은 정규화된 도메인 이름이어야 합니다.

11. 승인 유형에서 부하 분산기 승인을 선택합니다.

12. 인증서에 연결할 라벨을 지정합니다. 필요한 경우 두 개 이상의 라벨을 추가할 수 있습니다. 라벨을 추가하려면 add_box 라벨 추가 버튼을 클릭하고 라벨에 key 및 value를 지정합니다.

13. 만들기를 클릭합니다. 새 인증서가 인증서 목록에 표시되는지 확인합니다.

gcloud

gcloud certificate-manager certificates create CERTIFICATE_NAME \
    --domains="DOMAIN_NAMES"

다음을 바꿉니다.

• CERTIFICATE_NAME: 이 인증서를 설명하는 고유한 이름입니다.
• DOMAIN_NAMES: 쉼표로 구분된 이 인증서의 대상 도메인 목록입니다. 각 도메인 이름은 myorg.example.com과 같은 정규화된 도메인 이름이어야 합니다.

Terraform

Google 관리형 인증서를 만들려면 managed 블록과 함께 google_certificate_manager_certificate 리소스를 사용하면 됩니다.

resource "google_certificate_manager_certificate" "default" {
  name        = "prefixname-rootcert-${random_id.default.hex}"
  description = "Google-managed cert"
  managed {
    domains = ["example.me"]
  }
  labels = {
    "terraform" : true
  }
}

Terraform 구성을 적용하거나 삭제하는 방법은 기본 Terraform 명령어를 참조하세요.

API

다음과 같이 certificates.create 메서드에 POST 요청을 전송하여 인증서를 만듭니다.

POST /v1/projects/PROJECT_ID/locations/global/certificates?certificate_id=CERTIFICATE_NAME
{
 "managed": {
  "domains": ["DOMAIN_NAME"],
 }
}

다음을 바꿉니다.

• PROJECT_ID: 대상 Google Cloud 프로젝트의 ID입니다.
• CERTIFICATE_NAME: 이 인증서를 설명하는 고유한 이름입니다.
• DOMAIN_NAME: 이 인증서의 대상 도메인입니다. 도메인 이름은 myorg.example.com과 같은 정규화된 도메인 이름이어야 합니다.

콘솔

1. Google Cloud 콘솔에서 인증서 관리자 페이지로 이동합니다.

   인증서 관리자로 이동

2. 표시되는 페이지에서 인증서 탭을 선택합니다.

3. 인증서 추가를 클릭합니다.

4. 인증서 이름을 입력합니다.

   이 이름은 프로젝트에서 고유해야 합니다.

5. (선택사항) 인증서의 설명을 입력합니다. 설명은 나중에 특정 인증서를 식별하는 데 도움이 됩니다.

6. 위치에 전역을 선택합니다.

7. 범위에서 기본값을 선택합니다.

8. 인증서 유형에서 Google 관리형 인증서 만들기를 선택합니다.

9. 인증 기관 유형에서 공개를 선택합니다.

10. 인증서의 도메인 이름을 지정합니다. 쉼표로 구분된 대상 도메인의 목록을 입력합니다. 또한 각 도메인 이름은 myorg.example.com과 같은 정규화된 도메인 이름이어야 합니다.

11. 승인 유형에서 DNS 승인을 선택합니다. 도메인 이름에 연결된 DNS 승인이 있는 경우 자동으로 선택됩니다. 도메인 이름에 연결된 DNS 승인이 없는 경우 다음 단계를 따르세요.

    1. 누락된 DNS 승인 만들기를 클릭하여 DNS 승인 만들기 대화상자를 표시합니다.
    2. DNS 승인 이름 필드에 DNS 승인 이름을 지정합니다.
    3. 여러 프로젝트에서 인증서를 독립적으로 관리하려면 프로젝트별 승인을 선택합니다.
    4. DNS 승인 만들기를 클릭합니다. DNS 이름이 도메인 이름에 연결되는지 확인합니다.

12. 인증서에 연결할 라벨을 지정합니다. 필요한 경우 두 개 이상의 라벨을 추가할 수 있습니다. 라벨을 추가하려면 add_box 라벨 추가 버튼을 클릭하고 라벨에 key 및 value를 지정합니다.

13. 만들기를 클릭합니다. 새 인증서가 인증서 목록에 표시되는지 확인합니다.

gcloud

gcloud certificate-manager certificates create CERTIFICATE_NAME \
    --domains="DOMAIN_NAMES" \
    --dns-authorizations="AUTHORIZATION_NAMES"

다음을 바꿉니다.

• CERTIFICATE_NAME: 이 인증서를 설명하는 고유한 이름입니다.
• DOMAIN_NAMES: 쉼표로 구분된 이 인증서의 대상 도메인 목록입니다. 각 도메인 이름은 myorg.example.com과 같은 정규화된 도메인 이름이어야 합니다.
• AUTHORIZATION_NAMES: 이 인증서에 만든 DNS 승인의 이름을 쉼표로 구분한 목록입니다.

와일드 카드 도메인 이름으로 Google 관리형 인증서를 만들려면 다음 명령어를 사용합니다. 와일드 카드 도메인 이름 인증서는 지정된 도메인의 모든 첫 번째 수준 하위 도메인을 포함합니다.

gcloud certificate-manager certificates create CERTIFICATE_NAME \
    --domains="*.DOMAIN_NAME,DOMAIN_NAME" \
    --dns-authorizations=AUTHORIZATION_NAME

다음을 바꿉니다.

• CERTIFICATE_NAME: 이 인증서를 설명하는 고유한 이름입니다.
• DOMAIN_NAME: 이 인증서의 대상 도메인입니다. 별표 점 프리픽스(*.) 프리픽스는 와일드 카드 인증서를 나타냅니다. 도메인 이름은 myorg.example.com과 같은 정규화된 도메인 이름이어야 합니다.
• AUTHORIZATION_NAME: 이 인증서에 만든 DNS 승인의 이름입니다.

Terraform

DNS 승인으로 Google 관리형 인증서를 만들려면 managed 블록의 dns_authorizations 속성과 함께 google_certificate_manager_certificate 리소스를 사용하면 됩니다.

resource "google_certificate_manager_certificate" "root_cert" {
  name        = "${local.name}-rootcert-${random_id.tf_prefix.hex}"
  description = "The wildcard cert"
  managed {
    domains = [local.domain, "*.${local.domain}"]
    dns_authorizations = [
      google_certificate_manager_dns_authorization.default.id
    ]
  }
  labels = {
    "terraform" : true
  }
}

Terraform 구성을 적용하거나 삭제하는 방법은 기본 Terraform 명령어를 참조하세요.

API

다음과 같이 certificates.create 메서드에 POST 요청을 전송하여 인증서를 만듭니다.

POST /v1/projects/PROJECT_ID/locations/global/certificates?certificate_id=CERTIFICATE_NAME
{
 "managed": {
  "domains": ["DOMAIN_NAME"],
  "dnsAuthorizations": [
   "projects/PROJECT_ID/locations/global/dnsAuthorizations/AUTHORIZATION_NAME",
  ],
 }
}

다음을 바꿉니다.

• PROJECT_ID: 대상 Google Cloud 프로젝트의 ID입니다.
• CERTIFICATE_NAME: 이 인증서를 설명하는 고유한 이름입니다.
• DOMAIN_NAME: 이 인증서의 대상 도메인입니다. 별표 점 프리픽스(*.)는 와일드 카드 인증서를 나타냅니다. 도메인 이름은 myorg.example.com과 같은 정규화된 도메인 이름이어야 합니다.
• AUTHORIZATION_NAME: 이 인증서에 만든 DNS 승인의 이름입니다.

콘솔

1. Google Cloud 콘솔에서 인증서 관리자 페이지로 이동합니다.

   인증서 관리자로 이동

2. 발급 구성 탭에서 만들기를 클릭합니다.

3. 이름 필드에 고유한 인증서 발급 구성 이름을 입력합니다.

4. 위치에서 전역을 선택합니다.

5. (선택사항) 설명 필드에 발급 구성에 대한 설명을 입력합니다.

6. 전체 기간 필드에 발급된 인증서 전체 기간을 일 단위로 지정합니다. 값은 21~30일(포함) 사이여야 합니다.

7. 순환 기간 비율에서 갱신 프로세스가 시작될 때 인증서 수명 비율을 지정합니다. 유효한 값 범위를 찾으려면 전체 기간 및 순환 기간 비율을 참조하세요.

8. 키 알고리즘 목록에서 비공개 키를 생성할 때 사용할 키 알고리즘을 선택합니다.

9. CA 풀 목록에서 이 인증서 발급 구성에 할당할 CA 풀의 이름을 선택합니다.

10. 라벨 필드에서 인증서에 연결할 라벨을 지정합니다. 라벨을 추가하려면 add_box 라벨 추가를 클릭하고 라벨에 key 및 value를 지정합니다.

11. 만들기를 클릭합니다.

gcloud

 gcloud certificate-manager issuance-configs create ISSUANCE_CONFIG_NAME \
     --ca-pool=CA_POOL \
     [--lifetime=CERTIFICATE_LIFETIME] \
     [--rotation-window-percentage=ROTATION_WINDOW_PERCENTAGE] \
     [--key-algorithm=KEY_ALGORITHM]
 

다음을 바꿉니다.

• ISSUANCE_CONFIG_NAME: 이 인증서 발급 구성 리소스를 식별하는 고유한 이름입니다.
• CA_POOL: 이 인증서 발급 구성 리소스에 할당할 CA 풀의 전체 리소스 경로와 이름입니다.
• CERTIFICATE_LIFETIME: 인증서 수명(일)입니다. 유효한 값은 표준 기간 형식의 21~30일입니다. 기본값은 30일(30D)입니다. 이 설정은 선택사항입니다.
• ROTATION_WINDOW_PERCENTAGE: 인증서 갱신이 트리거되는 인증서 수명 비율입니다. 유효한 값 범위를 찾으려면 전체 기간 및 순환 기간 비율을 참조하세요. 이 설정은 선택사항입니다.
• KEY_ALGORITHM: 비공개 키를 생성하는 데 사용되는 암호화 알고리즘입니다. 유효한 값은 ecdsa-p256 또는 rsa-2048입니다. 기본값은 rsa-2048입니다. 이 설정은 선택사항입니다.

인증서 발급 구성 리소스에 대한 자세한 내용은 인증서 발급 구성 관리를 참조하세요.

콘솔

1. Google Cloud 콘솔에서 인증서 관리자 페이지로 이동합니다.

   인증서 관리자로 이동

2. 표시되는 페이지에서 인증서 탭을 선택합니다.

3. 인증서 추가를 클릭합니다.

4. 인증서 이름을 입력합니다.

   이 이름은 프로젝트에서 고유해야 합니다.

5. (선택사항) 인증서의 설명을 입력합니다. 설명은 나중에 특정 인증서를 식별하는 데 도움이 됩니다.

6. 위치에 전역을 선택합니다.

7. 범위에서 기본값을 선택합니다.

8. 인증서 유형에서 Google 관리형 인증서 만들기를 선택합니다.

9. 인증 기관 유형에서 비공개를 선택합니다.

10. 인증서의 도메인 이름을 지정합니다. 쉼표로 구분된 대상 도메인의 목록을 입력합니다. 또한 각 도메인 이름은 myorg.example.com과 같은 정규화된 도메인 이름이어야 합니다.

11. 인증서 발급 구성에서 대상 CA 풀을 참조하는 인증서 발급 구성 리소스의 이름을 선택합니다.

    발급 구성을 만들려면 인증서 발급 구성 추가를 클릭하고 다음 세부정보를 지정한 후 만들기를 클릭합니다.

    • 이름: 인증서 발급 구성의 고유한 이름입니다.
    • 설명: 발급 구성에 대한 설명입니다.
    • 전체 기간: 발급된 인증서의 전체 기간(일)입니다. 값은 21~30일(포함) 사이여야 합니다.
    • 순환 기간 비율: 인증서 갱신이 트리거되는 인증서 수명 비율입니다. 유효한 값 범위를 찾으려면 전체 기간 및 순환 기간 비율을 참조하세요.
    • 키 알고리즘: 비공개 키를 생성할 때 사용할 키 알고리즘입니다.
    • CA 풀: 이 인증서 발급 구성에 할당할 CA 풀의 이름입니다.
    • 라벨: 인증서 발급 구성에 연결할 라벨입니다.

12. 인증서에 연결할 라벨을 지정합니다. 필요한 경우 두 개 이상의 라벨을 추가할 수 있습니다. 라벨을 추가하려면 add_box 라벨 추가 버튼을 클릭하고 라벨에 key 및 value를 지정합니다.

13. 만들기를 클릭합니다. 새 인증서가 인증서 목록에 표시되는지 확인합니다.

gcloud

gcloud certificate-manager certificates create CERTIFICATE_NAME \
    --domains="DOMAIN_NAMES" \
    --issuance-config=ISSUANCE_CONFIG_NAME

다음을 바꿉니다.

• CERTIFICATE_NAME: 이 인증서를 설명하는 고유한 이름입니다.
• DOMAIN_NAMES: 쉼표로 구분된 이 인증서의 대상 도메인 목록입니다. 각 도메인 이름은 myorg.example.com과 같은 정규화된 도메인 이름이어야 합니다.
• ISSUANCE_CONFIG_NAME: 대상 CA 풀을 참조하는 인증서 발급 구성 리소스의 이름입니다.

API

다음과 같이 certificates.create 메서드에 POST 요청을 전송하여 인증서를 만듭니다.

POST /v1/projects/PROJECT_ID/locations/global/certificates?certificate_id=CERTIFICATE_NAME
{
 "managed": {
  "domains": ["DOMAIN_NAME"],
  "issuanceConfig": ["ISSUANCE_CONFIG_NAME"],
 }
}

다음을 바꿉니다.

• PROJECT_ID: 대상 Google Cloud 프로젝트의 ID입니다.
• CERTIFICATE_NAME: 이 인증서를 설명하는 고유한 이름입니다.
• DOMAIN_NAME: 이 인증서의 대상 도메인입니다. 도메인 이름은 myorg.example.com과 같은 정규화된 도메인 이름이어야 합니다.
• ISSUANCE_CONFIG_NAME: 대상 CA 풀을 참조하는 인증서 발급 구성 리소스의 이름입니다.

콘솔

1. Google Cloud 콘솔에서 인증서 관리자 페이지로 이동합니다.

   인증서 관리자로 이동

2. 발급 구성 탭에서 만들기를 클릭합니다.

3. 이름 필드에 고유한 인증서 발급 구성 이름을 입력합니다.

4. (선택사항) 설명 필드에 발급 구성에 대한 설명을 입력합니다.

5. 위치로 리전을 선택합니다.

6. 리전 목록에서 리전을 선택합니다.

7. 전체 기간 필드에 발급된 인증서 전체 기간을 일 단위로 지정합니다. 값은 21~30일(포함) 사이여야 합니다.

8. 순환 기간 비율에서 갱신 프로세스가 시작될 때 인증서 수명 비율을 지정합니다. 유효한 값 범위를 찾으려면 전체 기간 및 순환 기간 비율을 참조하세요.

9. 키 알고리즘 목록에서 비공개 키를 생성할 때 사용할 키 알고리즘을 선택합니다.

10. CA 풀 목록에서 이 인증서 발급 구성에 할당할 CA 풀의 이름을 선택합니다.

11. 라벨 필드에서 인증서에 연결할 라벨을 지정합니다. 라벨을 추가하려면 add_box 라벨 추가를 클릭하고 라벨에 key 및 value를 지정합니다.

12. 만들기를 클릭합니다.

gcloud

gcloud beta certificate-manager issuance-configs create ISSUANCE_CONFIG_NAME \
    --ca-pool=CA_POOL \
    --location=LOCATION> \
    [--lifetime=CERTIFICATE_LIFETIME] \
    [--rotation-window-percentage=ROTATION_WINDOW_PERCENTAGE] \
    [--key-algorithm=KEY_ALGORITHM] \

다음을 바꿉니다.

• ISSUANCE_CONFIG_NAME: 인증서 발급 구성 리소스의 고유한 이름입니다.
• CA_POOL: 이 인증서 발급 구성 리소스에 할당할 CA 풀의 전체 리소스 경로와 이름입니다.
• LOCATION: 대상 Google Cloud 위치입니다. CA 풀, 인증서 발급 구성 리소스, 관리형 인증서와 동일한 위치를 지정해야 합니다.
• CERTIFICATE_LIFETIME: 인증서 수명(일)입니다. 유효한 값은 표준 기간 형식의 21~30일입니다. 기본값은 30일(30D)입니다. 이 설정은 선택사항입니다.
• ROTATION_WINDOW_PERCENTAGE: 갱신 프로세스가 시작될 때 인증서 수명 비율입니다. 유효한 값 범위를 찾으려면 전체 기간 및 순환 기간 비율을 참조하세요.
• KEY_ALGORITHM: 비공개 키를 생성하는 데 사용되는 암호화 알고리즘입니다. 유효한 값은 ecdsa-p256 또는 rsa-2048입니다. 기본값은 rsa-2048입니다. 이 설정은 선택사항입니다.
• DESCRIPTION: 인증서 발급 구성 리소스에 대한 설명입니다. 이 설정은 선택사항입니다.

콘솔

1. Google Cloud 콘솔에서 인증서 관리자 페이지로 이동합니다.

   인증서 관리자로 이동

2. 표시되는 페이지에서 인증서 탭을 선택합니다.

3. 인증서 추가를 클릭합니다.

4. 인증서 이름을 입력합니다.

   이 이름은 프로젝트에서 고유해야 합니다.

5. (선택사항) 인증서의 설명을 입력합니다. 설명은 나중에 특정 인증서를 식별하는 데 도움이 됩니다.

6. 위치에 리전을 선택합니다.

7. 리전 목록에서 리전을 선택합니다.

8. 인증서 유형에서 Google 관리형 인증서 만들기를 선택합니다.

9. 인증 기관 유형에서 비공개를 선택합니다.

10. 인증서의 도메인 이름을 지정합니다. 쉼표로 구분된 대상 도메인의 목록을 입력합니다. 또한 각 도메인 이름은 myorg.example.com과 같은 정규화된 도메인 이름이어야 합니다.

11. 인증서 발급 구성에서 대상 CA 풀을 참조하는 인증서 발급 구성 리소스의 이름을 선택합니다.

    발급 구성을 만들려면 인증서 발급 구성 추가를 클릭하고 다음 세부정보를 지정한 후 만들기를 클릭합니다.

    • 이름: 인증서 발급 구성의 고유한 이름입니다.
    • 설명: 발급 구성에 대한 설명입니다.
    • 전체 기간: 발급된 인증서의 전체 기간(일)입니다. 값은 21~30일(포함) 사이여야 합니다.
    • 순환 기간 비율: 갱신 프로세스가 시작될 때 인증서 수명 비율입니다. 유효한 값 범위를 찾으려면 전체 기간 및 순환 기간 비율을 참조하세요.
    • 키 알고리즘: 비공개 키를 생성할 때 사용할 키 알고리즘입니다.
    • CA 풀: 이 인증서 발급 구성에 할당할 CA 풀의 이름입니다.
    • 라벨: 인증서 발급 구성에 연결할 라벨입니다.

12. 인증서에 연결할 라벨을 지정합니다. 필요한 경우 두 개 이상의 라벨을 추가할 수 있습니다. 라벨을 추가하려면 add_box 라벨 추가 버튼을 클릭하고 라벨에 key 및 value를 지정합니다.

13. 만들기를 클릭합니다. 새 인증서가 인증서 목록에 표시되는지 확인합니다.

gcloud

다음 명령어를 실행합니다.

gcloud beta certificate-manager certificates create CERTIFICATE_NAME \
    --domains="DOMAIN_NAMES" \
    --issuance-config="ISSUANCE_CONFIG_NAME" \
    --location="LOCATION"

다음을 바꿉니다.

• CERTIFICATE_NAME: 인증서의 고유한 이름입니다.
• DOMAIN_NAMES: 쉼표로 구분된 이 인증서의 대상 도메인 목록입니다. 각 도메인 이름은 myorg.example.com과 같은 정규화된 도메인 이름이어야 합니다.
• ISSUANCE_CONFIG_NAME: 대상 CA 풀을 참조하는 인증서 발급 구성 리소스의 이름입니다.
• LOCATION: 대상 Google Cloud 위치입니다. CA 풀, 인증서 발급 구성 리소스, 관리형 인증서와 동일한 위치를 지정해야 합니다.

API

다음과 같이 certificates.create 메서드에 POST 요청을 전송하여 인증서를 만듭니다.

POST /v1/projects/PROJECT_ID/locations/LOCATION/certificates?
{
certificate: {
    name: "/projects/example-project/locations/LOCATION/certificates/my-cert",
    "managed": {
        "domains": ["DOMAIN_NAME"],
        "issuanceConfig": "ISSUANCE_CONFIG_NAME",
              },
             }
}

다음을 바꿉니다.

• PROJECT_ID: 대상 Google Cloud 프로젝트의 ID입니다.
• CERTIFICATE_NAME: 인증서의 고유한 이름입니다.
• DOMAIN_NAME: 이 인증서의 대상 도메인입니다. 도메인 이름은 example.com, www.example.com과 같은 정규화된 도메인 이름이어야 합니다.
• ISSUANCE_CONFIG_NAME: 대상 CA 풀을 참조하는 인증서 발급 구성 리소스의 이름입니다.
• LOCATION: 대상 Google Cloud 위치입니다. CA 풀, 인증서 발급 구성 리소스, 관리형 인증서와 동일한 위치를 지정해야 합니다.

콘솔

1. Google Cloud 콘솔에서 인증서 관리자 페이지로 이동합니다.

   인증서 관리자로 이동

2. 표시되는 페이지에서 인증서 탭을 선택합니다.

3. 인증서 추가를 클릭합니다.

4. 인증서 이름을 입력합니다.

   이 이름은 프로젝트에서 고유해야 합니다.

5. (선택사항) 인증서의 설명을 입력합니다. 설명은 나중에 특정 인증서를 식별하는 데 도움이 됩니다.

6. 위치에 리전을 선택합니다.

7. 리전 목록에서 리전을 선택합니다.

8. 인증서 유형에서 Google 관리형 인증서 만들기를 선택합니다.

9. 인증 기관 유형에서 공개를 선택합니다.

10. 인증서의 도메인 이름을 지정합니다. 쉼표로 구분된 대상 도메인의 목록을 입력합니다. 또한 각 도메인 이름은 myorg.example.com과 같은 정규화된 도메인 이름이어야 합니다.

11. 승인 유형에서 DNS 승인을 선택합니다. 도메인 이름에 연결된 DNS 승인이 있는 경우 자동으로 선택됩니다. 도메인 이름에 연결된 DNS 승인이 없는 경우 다음 단계를 따르세요.

    1. 누락된 DNS 승인 만들기를 클릭하여 DNS 승인 만들기 대화상자를 표시합니다.
    2. DNS 승인 이름 필드에 DNS 승인 이름을 지정합니다.
    3. DNS 승인 만들기를 클릭합니다. DNS 이름이 도메인 이름에 연결되는지 확인합니다.

12. 인증서에 연결할 라벨을 지정합니다. 필요한 경우 두 개 이상의 라벨을 추가할 수 있습니다. 라벨을 추가하려면 add_box 라벨 추가 버튼을 클릭하고 라벨에 key 및 value를 지정합니다.

13. 만들기를 클릭합니다. 새 인증서가 인증서 목록에 표시되는지 확인합니다.

gcloud

다음 명령어를 실행합니다.

gcloud certificate-manager certificates create CERTIFICATE_NAME \
   --domains=DOMAIN_NAME \
   --dns-authorizations=AUTHORIZATION_NAME \
   --location=LOCATION

다음을 바꿉니다.

• CERTIFICATE_NAME: 인증서의 고유한 이름입니다.
• DOMAIN_NAME: 인증서의 대상 도메인입니다. 도메인 이름은 myorg.example.com과 같은 정규화된 도메인 이름이어야 합니다.
• AUTHORIZATION_NAME: 이 인증서에 만든 DNS 승인의 이름입니다.
• LOCATION: Google 관리형 인증서를 만들 위치입니다.

와일드 카드 도메인 이름으로 Google 관리형 인증서를 만들려면 다음 명령어를 사용합니다. 와일드 카드 도메인 이름 인증서는 지정된 도메인의 모든 첫 번째 수준 하위 도메인을 포함합니다.

gcloud certificate-manager certificates create CERTIFICATE_NAME \
   --domains="*.DOMAIN_NAME,DOMAIN_NAME" \
   --dns-authorizations=AUTHORIZATION_NAME
   --location=LOCATION

다음을 바꿉니다.

• CERTIFICATE_NAME: 인증서의 고유한 이름입니다.
• DOMAIN_NAME: 인증서의 대상 도메인입니다. 별표 점 프리픽스(*.)는 와일드 카드 인증서를 나타냅니다. 도메인 이름은 myorg.example.com과 같은 정규화된 도메인 이름이어야 합니다.
• AUTHORIZATION_NAME: 이 인증서에 만든 DNS 승인의 이름입니다.
• LOCATION: Google 관리형 인증서를 만들 위치입니다.

콘솔

1. Google Cloud 콘솔에서 인증서 관리자 페이지로 이동합니다.

   인증서 관리자로 이동

2. 표시되는 페이지에서 인증서 탭을 선택합니다.

3. 인증서 추가를 클릭합니다.

4. 인증서 이름을 입력합니다.

   이 이름은 프로젝트에서 고유해야 합니다.

5. (선택사항) 인증서의 설명을 입력합니다. 설명은 나중에 특정 인증서를 식별하는 데 도움이 됩니다.

6. 위치에서 다음 중 하나를 선택합니다.

   • 전역: 인증서를 전 세계에서 사용할 수 있도록 전역을 선택합니다. 전역을 선택한 경우 범위 드롭다운 메뉴에서 다음 중 하나를 선택합니다.
     • 기본값: 기본 범위의 인증서는 핵심 Google 데이터 센터에서 제공됩니다.
     • 에지 캐시: 이 범위의 인증서는 특수 인증서이며 비핵심 Google 데이터 센터에서 제공됩니다.
     • 모든 리전: 모든 리전에서 인증서가 제공됩니다.
   • 리전: 인증서를 특정 리전에서 사용할 수 있도록 리전을 선택합니다. 리전을 선택한 경우 리전 목록에서 리전을 선택합니다.

7. 인증서 유형에서 자체 관리형 인증서 만들기를 선택합니다.

8. 인증서 필드에서 다음 중 하나를 수행합니다.

   • 업로드 버튼을 클릭하고 PEM 형식의 인증서 파일을 선택합니다.
   • PEM 형식 인증서의 내용을 복사하여 붙여넣습니다. 내용은 -----BEGIN CERTIFICATE-----로 시작하고 -----END CERTIFICATE-----로 끝나야 합니다.

9. 비공개 키 인증서 필드에서 다음 중 하나를 수행하세요.

   • 업로드 버튼을 클릭하고 비공개 키를 선택합니다. 비공개 키는 PEM 형식이어야 하며 암호로 보호되지 않습니다.
   • PEM 형식의 비공개 키 내용을 복사하여 붙여넣습니다. 비공개 키는 -----BEGIN PRIVATE KEY-----로 시작하고 -----END PRIVATE KEY-----로 끝나야 합니다.

10. 인증서에 연결할 라벨을 지정합니다. 필요한 경우 두 개 이상의 라벨을 추가할 수 있습니다. 라벨을 추가하려면 add_box 라벨 추가 버튼을 클릭하고 라벨에 key 및 value를 지정합니다.

11. 만들기를 클릭합니다. 새 인증서가 인증서 목록에 표시되는지 확인합니다.

gcloud

gcloud certificate-manager certificates create  CERTIFICATE_NAME \
    --certificate-file="CERTIFICATE_FILE" \
    --private-key-file="PRIVATE_KEY_FILE" \
    [--location="REGION"]

다음을 바꿉니다.

• CERTIFICATE_NAME: 이 인증서를 설명하는 고유한 이름입니다.
• CERTIFICATE_FILE: .crt 인증서 파일의 경로와 파일 이름입니다.
• PRIVATE_KEY_FILE: .key 비공개 키 파일의 경로와 파일 이름입니다.
• REGION: 대상 Google Cloud 리전입니다. 기본값은 global입니다. 이 설정은 선택사항입니다.

Terraform

자체 관리형 인증서를 업로드하려면 self_managed 블록과 함께 google_certificate_manager_certificate 리소스를 사용하면 됩니다.

API

다음과 같이 certificates.create 메서드에 POST 요청을 전송하여 인증서를 만듭니다.

POST /v1/projects/PROJECT_ID/locations/[REGION]/certificates?certificate_id=CERTIFICATE_NAME
{
  self_managed: {
    pem_certificate: "PEM_CERTIFICATE",
    pem_private_key: "PEM_KEY",
  }
}

다음을 바꿉니다.

• PROJECT_ID: 대상 Google Cloud 프로젝트의 ID입니다.
• CERTIFICATE_NAME: 이 인증서를 설명하는 고유한 이름입니다.
• PEM_CERTIFICATE: 인증서 PEM입니다.
• PEM_KEY: 키 PEM입니다.
• REGION: 대상 Google Cloud 리전입니다. 기본값은 global입니다. 이 설정은 선택사항입니다.

gcloud

gcloud certificate-manager certificates update CERTIFICATE_NAME \
    --certificate-file="CERTIFICATE_FILE" \
    --private-key-file="PRIVATE_KEY_FILE" \
    --description="DESCRIPTION" \
    --update-labels="LABELS" \
    [--location="REGION"]

다음을 바꿉니다.

• CERTIFICATE_NAME: 대상 인증서의 이름입니다.
• CERTIFICATE_FILE: .crt 인증서 파일의 경로와 파일 이름입니다.
• PRIVATE_KEY_FILE: .key 비공개 키 파일의 경로와 파일 이름입니다.
• DESCRIPTION: 이 인증서에 대한 고유한 설명 값입니다.
• LABELS: 이 인증서에 적용된 쉼표로 구분된 라벨 목록입니다.
• REGION: 대상 Google Cloud 리전입니다. 기본값은 global입니다. 이 설정은 선택사항입니다.

API

다음과 같이 certificates.patch 메서드에 PATCH 요청을 전송하여 인증서를 만듭니다.

PATCH /v1/projects/PROJECT_ID/locations/[REGION]/certificates/CERTIFICATE_NAME?updateMask=self_managed,labels,description
{
   self_managed: { // Self-managed certificates only
    pem_certificate: "PEM_CERTIFICATE",
    pem_private_key: "PEM_KEY",
  }
  "description": "DESCRIPTION",
  "labels": {
    "LABEL_KEY": "LABEL_VALUE",
  }

}

다음을 바꿉니다.

• PROJECT_ID: 대상 Google Cloud 프로젝트의 ID입니다.
• REGION: 대상 Google Cloud 리전입니다. 기본값은 global입니다. 이 설정은 선택사항입니다.
• CERTIFICATE_NAME: 대상 인증서의 이름입니다.
• PEM_CERTIFICATE: 인증서 PEM입니다.
• PEM_KEY: 키 PEM입니다.
• DESCRIPTION: 이 인증서에 대한 의미 있는 설명입니다.
• LABEL_KEY: 이 인증서에 적용된 라벨 키입니다.
• LABEL_VALUE: 이 인증서에 적용되는 라벨 값입니다.

콘솔

인증서 관리자에서 관리하는 프로젝트에 인증서가 10,000개가 넘는 경우 Google Cloud 콘솔의 인증서 관리자 페이지에 인증서를 나열할 수 없습니다. 이러한 경우 대신 gcloud CLI 명령어를 사용하여 인증서를 나열합니다.

1. Google Cloud 콘솔에서 인증서 관리자 페이지로 이동합니다.

   인증서 관리자로 이동

2. 표시되는 페이지에서 인증서 탭을 선택합니다. 이 탭에는 선택한 프로젝트의 인증서 관리자가 관리하는 모든 인증서가 나열됩니다.

기존 인증서 탭에는 Cloud Load Balancing을 통해 직접 프로비저닝된 선택한 프로젝트의 인증서가 나열됩니다. 기존 인증서는 인증서 관리자로 관리되지 않습니다. 이러한 인증서를 관리하는 방법은 Cloud Load Balancing 문서의 다음 문서 중 하나를 참조하세요.

• Google 관리형 SSL 인증서 사용
• 자체 관리형 SSL 인증서 사용

gcloud

gcloud certificate-manager certificates list \
    [--location="REGION"] \
    --filter="FILTER" \
    --page-size="PAGE_SIZE" \
    --limit="LIMIT" \
    --sort-by="SORT_BY"

다음을 바꿉니다.

• REGION: 대상 Google Cloud 리전입니다. 모든 리전의 인증서를 나열하려면 -를 값으로 사용합니다. 기본값은 global입니다. 이 설정은 선택사항입니다.
• FILTER: 반환된 결과를 특정 값으로 제한하는 표현식입니다. 예를 들어 다음 기준에 따라 결과를 필터링할 수 있습니다.
  • 만료 시간: --filter='expire_time >= "2021-09-01T00:00:00Z"'
  • SAN DNS 이름: --filter='san_dnsnames:"example.com"'
  • 인증서 상태: --filter='managed.state=FAILED'
  • 인증서 유형: --filter='managed:*'
  • 라벨 및 생성 시간: --filter='labels.key:value AND create_time > "2021-09-01T00:00:00Z"'

인증서 관리자에서 사용할 수 있는 필터링 예시는 Cloud Key Management Service 문서의 목록 결과 정렬 및 필터링을 참조하세요.

• PAGE_SIZE: 페이지당 반환할 결과 수입니다.
• LIMIT: 반환할 최대 결과 수입니다.
• SORT_BY: 쉼표로 구분된 name 필드의 목록으로, 반환된 결과가 정렬됩니다. 기본 정렬 순서는 오름차순입니다. 내림차순 정렬의 경우 필드 앞에 ~를 붙입니다.

API

다음과 같이 certificates.list 메서드에 LIST 요청을 전송하여 인증서를 나열합니다.

GET /v1/projects/PROJECT_ID/locations/REGION/certificates?filter=FILTER&pageSize=PAGE_SIZE&sortBy=SORT_BY

다음을 바꿉니다.

• REGION: 대상 Google Cloud 리전입니다. 모든 리전의 인증서를 나열하려면 -를 값으로 사용합니다.
• PROJECT_ID: 대상 Google Cloud 프로젝트의 ID입니다.
• FILTER: 반환된 결과를 특정 값으로 제한하는 표현식입니다.
• PAGE_SIZE: 페이지당 반환할 결과 수입니다.
• SORT_BY: 반환된 결과를 정렬하는 쉼표로 구분된 필드 이름 목록입니다. 기본 정렬 순서는 오름차순입니다. 내림차순 정렬의 경우 필드 앞에 ~를 붙입니다.

콘솔

인증서 관리자에서 관리하는 프로젝트에 인증서가 10,000개가 넘는 경우 Google Cloud 콘솔의 인증서 관리자 페이지에 인증서를 나열할 수 없습니다. 이러한 경우 대신 gcloud CLI 명령어를 사용하여 인증서를 나열합니다. 하지만 인증서의 세부정보 페이지로 직접 연결되는 링크는 Google Cloud 콘솔의 인증서 관리자 페이지에 이러한 세부정보가 표시될 수 있습니다.

1. Google Cloud 콘솔에서 인증서 관리자 페이지로 이동합니다.

   인증서 관리자로 이동

2. 표시되는 페이지에서 인증서 탭을 선택합니다.

3. 인증서 탭에서 대상 인증서로 이동한 다음 인증서 이름을 클릭합니다.

인증서 세부정보 페이지에 선택한 인증서에 자세한 정보가 표시됩니다.

1. 선택사항: 이 인증서에 대한 Certificate Manager API의 REST 응답을 보려면 동등한 REST를 클릭합니다.

2. 선택사항: 인증서에 확인하려는 연결된 인증서 발급 구성이 있으면 발급 구성 필드에서 연결된 인증서 발급 구성의 이름을 클릭합니다.

   Google Cloud 콘솔에는 인증서 발급 구성의 전체 구성이 표시됩니다.

gcloud

gcloud certificate-manager certificates describe CERTIFICATE_NAME \
    [--location="REGION"]

다음을 바꿉니다.

• CERTIFICATE_NAME: 대상 인증서의 이름입니다.
• REGION: 대상 Google Cloud 리전입니다. 기본값은 global입니다. 이 설정은 선택사항입니다.

API

다음과 같이 certificates.get 메서드에 GET 요청을 전송하여 인증서 상태를 확인합니다.

GET /v1/projects/PROJECT_ID/locations/REGION/certificates/CERTIFICATE_NAME

다음을 바꿉니다.

• PROJECT_ID: 대상 Google Cloud 프로젝트의 ID입니다.
• REGION: 대상 Google Cloud 리전입니다.
• CERTIFICATE_NAME: 대상 인증서의 이름입니다.

콘솔

1. Google Cloud 콘솔에서 인증서 관리자 페이지로 이동합니다.

   인증서 관리자로 이동

2. 인증서 탭에서 삭제할 인증서의 체크박스를 선택합니다.

3. 삭제를 클릭합니다.

4. 표시되는 대화상자에서 삭제를 클릭하여 확인합니다.

gcloud

gcloud certificate-manager certificates delete CERTIFICATE_NAME \
   [--location="REGION"]

다음을 바꿉니다.

• CERTIFICATE_NAME: 대상 인증서의 이름입니다.
• REGION: 대상 Google Cloud 리전입니다. 기본값은 global입니다. 이 설정은 선택사항입니다.

API

다음과 같이 certificates.delete 메서드에 DELETE 요청을 전송하여 인증서를 삭제합니다.

DELETE /v1/projects/PROJECT_ID/locations/REGION/certificates/CERTIFICATE_NAME

다음을 바꿉니다.

• PROJECT_ID: 대상 Google Cloud 프로젝트의 ID입니다.
• REGION: 대상 Google Cloud 리전입니다.
• CERTIFICATE_NAME: 대상 인증서의 이름입니다.