Application Integration에 지원되는 커넥터를 참조하세요.

인증 프로필 관리

Application Integration의 태스크에서 외부 애플리케이션, 서비스 또는 데이터 소스에 연결해야 할 수 있습니다. 인증 프로필을 사용하면 Application Integration의 연결에 대한 인증 세부정보를 구성하고 저장할 수 있습니다. 저장된 인증 프로필을 사용하도록 태스크를 구성할 수 있습니다. 인증 프로필 만들기는 일회성 작업이며 동일한 프로필을 여러 통합에서 재사용할 수 있습니다.

필요한 역할

인증 프로필을 관리하는 데 필요한 권한을 얻으려면 관리자에게 통합에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

Application Integration 관리자 (roles/integrations.integrationAdmin)
인증 프로필 만들기: Application Integration 편집자 (roles/integrations.integrationEditor)
인증 프로필 수정: Application Integration 편집자 (roles/integrations.integrationEditor)
인증 프로필 삭제: Application Integration 관리자 (roles/integrations.integrationAdmin)

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

OAuth 2.0 클라이언트 ID 만들기

클라이언트 ID는 Google OAuth 서버에서 단일 애플리케이션을 식별하는 데 사용됩니다. 애플리케이션이 여러 플랫폼에서 실행되는 경우 각 항목에 자체 클라이언트 ID가 필요합니다. 애플리케이션에서 OAuth 2.0을 사용하려면 OAuth 2.0 액세스 토큰을 요청할 때 애플리케이션에 사용되는 OAuth 2.0 클라이언트 ID가 필요합니다.

OAuth 2.0 클라이언트 ID를 만들려면 다음 단계를 수행합니다.

Google Cloud 콘솔에서 API 및 서비스> 사용자 인증 정보로 이동합니다.
사용자 인증 정보로 이동
+ 사용자 인증 정보 만들기를 클릭하고 사용 가능한 옵션 목록에서 OAuth 클라이언트 ID를 선택합니다.
OAuth 클라이언트 ID 만들기 페이지가 나타납니다.
애플리케이션 유형: 드롭다운 목록에서 웹 애플리케이션을 선택합니다.
이름: Cloud 콘솔에서 클라이언트를 식별하기 위해 OAuth 2.0 클라이언트 이름을 입력합니다.
승인된 리디렉션 URI에서 + URI 추가를 클릭하고 다음을 입력합니다.
```
 https://console.cloud.google.com/integrations/callback/locations/AUTH_PROFILE_REGION
```
만들기를 클릭합니다.
OAuth 2.0 클라이언트 ID가 성공적으로 생성됩니다.

새 인증 프로필 만들기

새 인증 프로필을 만들려면 다음 옵션 중 하나를 선택합니다.

콘솔

Google Cloud 콘솔에서 Application Integration 페이지로 이동합니다.
Application Integration으로 이동
탐색 메뉴에서 인증 프로필을 클릭합니다.

인증 프로필 페이지가 나타납니다.

만들기를 클릭하고 다음 세부정보를 입력합니다.
- 프로필 이름 필드에 통합 편집기에 표시할 인증 프로필의 이름을 입력합니다.
- 리전 목록에서 인증 프로필의 리전을 선택합니다.
- 설명 필드에 인증 프로필의 설명을 입력합니다.
- 계속을 클릭합니다.
- 인증 유형 목록에서 인증 유형을 선택하고 필요한 세부정보를 입력합니다. 선택에 따라 대화상자에 인증 사용자 인증 정보에 필요한 추가 필드가 표시됩니다. 선택할 수 있는 인증 유형은 다음과 같습니다.
- 원하는 경우 서버에서 클라이언트의 ID를 검증하는 데 사용되는 SSL/TLS 클라이언트 인증서를 추가할 수 있습니다. 다음 필드를 입력할 수 있습니다.
  1. SSL 인증서
  2. 비공개 키
  3. 비공개 키 암호
만들기를 클릭합니다.

Terraform

google_integrations_client 리소스를 사용합니다. Terraform을 사용하여 다음과 같은 인증 프로필을 만들 수 있습니다.

인증 토큰
SSL/TLS 클라이언트 인증 전용
JSON 웹 토큰(JWT)
OAuth 2.0 승인 코드
OAuth 2.0 클라이언트 사용자 인증 정보
OIDC ID 토큰
서비스 계정

인증 토큰

다음 예시에서는 us-central1 리전에 인증 토큰 인증 유형을 만듭니다

resource "google_integrations_client" "client" {
  location = "us-central1"
}

resource "google_integrations_auth_config" "auth_config_auth_token" {
  location     = "us-central1"
  display_name = "tf-auth-token"
  description  = "Test auth config created via terraform"
  decrypted_credential {
    credential_type = "AUTH_TOKEN"
    auth_token {
      type  = "Basic"
      token = "some-random-token"
    }
  }
  depends_on = [google_integrations_client.client]
}

SSL/TLS 클라이언트 인증서

다음 예시에서는 us-central1 리전에 SSL/TLS 클라이언트 인증 유형을 만듭니다.

resource "google_integrations_auth_config" "auth_config_certificate" {
  location     = "us-central1"
  display_name = "tf-certificate"
  description  = "Test auth config created via terraform"
  decrypted_credential {
    credential_type = "CLIENT_CERTIFICATE_ONLY"
  }
  client_certificate {
    ssl_certificate       = <<EOT
-----BEGIN CERTIFICATE-----
MIICTTCCAbagAwIBAgIJAPT0tSKNxan/MA0GCSqGSIb3DQEBCwUAMCoxFzAVBgNV
BAoTDkdvb2dsZSBURVNUSU5HMQ8wDQYDVQQDEwZ0ZXN0Q0EwHhcNMTUwMTAxMDAw
MDAwWhcNMjUwMTAxMDAwMDAwWjAuMRcwFQYDVQQKEw5Hb29nbGUgVEVTVElORzET
MBEGA1UEAwwKam9lQGJhbmFuYTCBnzANBgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEA
vDYFgMgxi5W488d9J7UpCInl0NXmZQpJDEHE4hvkaRlH7pnC71H0DLt0/3zATRP1
JzY2+eqBmbGl4/sgZKYv8UrLnNyQNUTsNx1iZAfPUflf5FwgVsai8BM0pUciq1NB
xD429VFcrGZNucvFLh72RuRFIKH8WUpiK/iZNFkWhZ0CAwEAAaN3MHUwDgYDVR0P
AQH/BAQDAgWgMB0GA1UdJQQWMBQGCCsGAQUFBwMBBggrBgEFBQcDAjAMBgNVHRMB
Af8EAjAAMBkGA1UdDgQSBBCVgnFBCWgL/iwCqnGrhTPQMBsGA1UdIwQUMBKAEKey
Um2o4k2WiEVA0ldQvNYwDQYJKoZIhvcNAQELBQADgYEAYK986R4E3L1v+Q6esBtW
JrUwA9UmJRSQr0N5w3o9XzarU37/bkjOP0Fw0k/A6Vv1n3vlciYfBFaBIam1qRHr
5dMsYf4CZS6w50r7hyzqyrwDoyNxkLnd2PdcHT/sym1QmflsjEs7pejtnohO6N2H
wQW6M0H7Zt8claGRla4fKkg=
-----END CERTIFICATE-----
EOT
    encrypted_private_key = <<EOT
-----BEGIN PRIVATE KEY-----
MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQCA/Oj2HXqs5fTk
j/8DrlOQtLG3K9RMsYHvnwICLxkGqVcTfut58hDFLbQM8C3C0ENAKitNJplCJmYG
8VpgZzgq8VxaGnlP/sXUFLMGksd5sATn0sY3SkPndTKk/dqqA4MIh/dYfh19ynEN
hB9Ll/h54Yic2je2Qaxe/uMMu8RODTz3oCn7FcoYpPvfygfU0ntn4IcqH/hts5DG
s+3otJk4entRZglQDxR+sWOsbLtJIQZDP8rH3jDVdl5l3wspgtMTY8b5T5+pLm0p
/OzCmxT0dq/O6BhpxI1xf/zcdRZeWk5DTJxTi5AgPquTlAG/B6A3HkqBJ14hT/Rk
iv7Ma3DLAgMBAAECggEABATkf9VfpiAT9zYdouk50bBpckvymQTyQLD8SlBaX+KY
kgv/pHSXK4Pm4iensrQerFLgfqPA3U+FiqjW5Mv7c1VRK6HJbuVkpdzoXLI9IQsL
vsBY7//9Ajk5P7NokjdB6JPdU/2dHROuQVa59cxPtzpHo0htnPlDOKXfFZZuoZ17
Nr8WQHrHy8P8ABM1tLOzvU9Nlh7TcjQvev+HxkLek4qzYyJ/Ac7XOjg/XKUm1tZk
O3BHr8YLabwyjO7l1t+2b14rUTL/8pfUZnAkEi3FAlPxm3ilftmX65zliC9G4ghk
dr5PByT3DqnuIIglua9bISv1H34ogecd+9a6EU7RxQKBgQC2RPKLounXZo8vYiU4
sFTEvjbs+u9Ypk4OrNLnb8KdacLBUaJGnf++xbBoKpwFCBJfy//fvuQfusYF9Gyn
GxL43tw94C/H5upQYnDsmnQak6TbOu3mA24OGK7Rcq6NEHgeCY4HomutnSiPTZJq
8jlpqgqh1itETe5avgkMNq3zBwKBgQC1KlztGzvbB+rUDc6Kfvk5pUbCSFKMMMa2
NWNXeD6i2iA56zEYSbTjKQ3u9pjUV8LNqAdUFxmbdPxZjheNK2dEm68SVRXPKOeB
EmQT+t/EyW9LqBEA2oZt3h2hXtK8ppJjQm4XUCDs1NphP87eNzx5FLzJWjG8VqDq
jOvApNqPHQKBgDQqlZSbgvvwUYjJOUf5R7mri0LWKwyfRHX0xsQQe43cCC6WM7Cs
Zdbu86dMkqzp+4BJfalHFDl0llp782D8Ybiy6CwZbvNyxptNIW7GYfZ9TVCllBMh
5izIqbgub4DWNtq591l+Bf2BnmstU3uiagYw8awSBP4eo9p6y1IgkDafAoGBAJbi
lIiqEP0IqA06/pWc0Qew3rD7OT0ndqjU6Es2i7xovURf3QDkinJThBZNbdYUzdsp
IgloP9yY33/a90SNLLIYlARJtyNVZxK59X4qiOpF9prlfFvgpOumfbkj15JljTB8
aGKkSvfVA5jRYwLysDwMCHwO0bOR1u3itos5AgsFAoGAKEGms1kuQ5/HyFgSmg9G
wBUzu+5Y08/A37rvyXsR6GjmlZJvULEopJNUNCOOpITNQikXK63sIFry7/59eGv5
UwKadZbfwbVF5ipu59UxfVE3lipf/mYePDqMkHVWv/8p+OnnJt9uKnyW8VSOu5uk
82QF30zbIWDTUjrcugVAs+E=
-----END PRIVATE KEY-----
EOT
  }
  depends_on = [google_integrations_client.client]
}

JSON 웹 토큰(JWT)

다음 예시에서는 us-central1 리전에 JSON 웹 토큰(JWT) 인증 유형을 만듭니다.

resource "google_integrations_auth_config" "auth_config_jwt" {
  location     = "us-central1"
  display_name = "tf-jwt"
  description  = "Test auth config created via terraform"
  decrypted_credential {
    credential_type = "JWT"
    jwt {
      jwt_header  = "{\"alg\": \"HS256\", \"typ\": \"JWT\"}"
      jwt_payload = "{\"sub\": \"1234567890\", \"name\": \"John Doe\", \"iat\": 1516239022}"
      secret      = "secret"
    }
  }
  depends_on = [google_integrations_client.client]
}

OAuth 2.0 승인 코드

다음 예시에서는 us-central1 리전에 SSL/TLS 클라이언트 인증 유형을 만듭니다.

resource "google_integrations_auth_config" "auth_config_oauth2_authorization_code" {
  location     = "us-central1"
  display_name = "tf-oauth2-authorization-code"
  description  = "Test auth config created via terraform"
  decrypted_credential {
    credential_type = "OAUTH2_AUTHORIZATION_CODE"
    oauth2_authorization_code {
      client_id      = "Kf7utRvgr95oGO5YMmhFOLo8"
      client_secret  = "D-XXFDDMLrg2deDgczzHTBwC3p16wRK1rdKuuoFdWqO0wliJ"
      scope          = "photo offline_access"
      auth_endpoint  = "https://authorization-server.com/authorize"
      token_endpoint = "https://authorization-server.com/token"
    }
  }
  depends_on = [google_integrations_client.client]
}

OAuth 2.0 클라이언트 사용자 인증 정보

다음 예시에서는 us-central1 리전에 OAuth 2.0 클라이언트 사용자 인증 정보 인증 유형을 만듭니다.

resource "google_integrations_auth_config" "auth_config_oauth2_client_credentials" {
  location     = "us-central1"
  display_name = "tf-oauth2-client-credentials"
  description  = "Test auth config created via terraform"
  decrypted_credential {
    credential_type = "OAUTH2_CLIENT_CREDENTIALS"
    oauth2_client_credentials {
      client_id      = "demo-backend-client"
      client_secret  = "MJlO3binatD9jk1"
      scope          = "read"
      token_endpoint = "https://login-demo.curity.io/oauth/v2/oauth-token"
      request_type   = "ENCODED_HEADER"
      token_params {
        entries {
          key {
            literal_value {
              string_value = "string-key"
            }
          }
          value {
            literal_value {
              string_value = "string-value"
            }
          }
        }
      }
    }
  }
  depends_on = [google_integrations_client.client]
}

Google OIDC ID 토큰

다음 예시에서는 us-central1 리전에 Google OIDC ID 토큰 인증 유형을 만듭니다.

resource "random_id" "default" {
  byte_length = 8
}

resource "google_service_account" "service_account" {
  account_id   = "sa-${random_id.default.hex}"
  display_name = "Service Account"
}

resource "google_integrations_auth_config" "auth_config_oidc_token" {
  location     = "us-central1"
  display_name = "tf-oidc-token"
  description  = "Test auth config created via terraform"
  decrypted_credential {
    credential_type = "OIDC_TOKEN"
    oidc_token {
      service_account_email = google_service_account.service_account.email
      audience = "https://us-central1-project.cloudfunctions.net/functionA 1234987819200.apps.googleusercontent.com"
    }
  }
depends_on = [google_service_account.service_account, google_integrations_client.client]
}

서비스 계정

다음 예시에서는 us-central1 리전에 서비스 계정 인증 유형을 만듭니다.

resource "random_id" "default" {
  byte_length = 8
}
  
resource "google_service_account" "service_account" {
  account_id   = "sa-${random_id.default.hex}"
  display_name = "Service Account"
}
resource "google_integrations_auth_config" "auth_config_service_account" {
  location     = "us-central1"
  display_name = "tf-service-account"
  description  = "Test auth config created via terraform"
  decrypted_credential {
    credential_type = "SERVICE_ACCOUNT"
    service_account_credentials {
    service_account = google_service_account.service_account.email
    scope = "https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/adexchange.buyer https://www.googleapis.com/auth/admob.readonly"
    }
  }
depends_on = [google_service_account.service_account, google_integrations_client.client]
}

저장한 후에는 새 인증 프로필을 인증이 필요한 모든 태스크의 사용할 승인 프로필 드롭다운의 옵션으로 사용할 수 있습니다.

선택사항. 통합 태스크를 구성하기 전에 인증 프로필을 만들지 않았으면 태스크 구성 창의 사용할 승인 프로필 드롭다운에서 + 새 인증 프로필 추가를 선택하여 프로필 만들기 대화상자에 액세스할 수 있습니다. 이전 단계에 따라 새 인증 프로필을 만듭니다.

인증 프로필 수정

인증 프로필을 수정하려면 다음 단계를 따르세요.

Google Cloud 콘솔에서 Application Integration 페이지로 이동합니다.
Application Integration으로 이동
탐색 메뉴에서 인증 프로필을 클릭합니다.

인증 프로필 페이지가 나타납니다.

인증 프로필 페이지의 드롭다운 메뉴를 사용하여 인증 프로필의 리전을 선택합니다.
(작업 메뉴)를 클릭하고 수정을 클릭합니다.
인증 프로필 대화상자가 나타납니다.
세부정보를 수정하고 저장을 클릭합니다.

인증 프로필 삭제

인증 프로필을 삭제하려면 다음 단계를 따르세요.

Google Cloud 콘솔에서 Application Integration 페이지로 이동합니다.
Application Integration으로 이동
탐색 메뉴에서 인증 프로필을 클릭합니다.

인증 프로필 페이지가 나타납니다.

인증 프로필 페이지의 드롭다운 메뉴를 사용하여 인증 프로필의 리전을 선택합니다.
삭제를 클릭합니다.

인증 유형

통합 태스크를 완료하는 데 필요한 인증 유형은 승인 서버에 구성된 인증에 따라 달라집니다. 승인 서버는 호출 클라이언트에 사용자 인증 정보를 발급하는 독립형 서버 또는 API일 수 있습니다. Application Integration은 다음과 같은 인증 유형을 지원합니다.

인증 토큰
Google OIDC ID 토큰
JSON 웹 토큰(JWT)
OAuth 2.0 승인 코드
OAuth 2.0 클라이언트 사용자 인증 정보
OAuth 2.0 리소스 소유자 비밀번호 사용자 인증 정보
SSL/TLS 클라이언트 인증 전용
서비스 계정

다음 섹션에서는 인증 유형의 구성 속성을 설명합니다.

인증 토큰

인증 토큰 인증 유형은 인증에 토큰(사용자 인증 정보)을 사용합니다. 사용자 인증 정보는 Authorization: TYPE CREDENTIALS 형식의 HTTP Authorization 요청 헤더의 서버로 전송됩니다. 이 인증 유형을 구성하려면 다음 속성을 설정합니다.

유형: Basic, Bearer 또는 MAC과 같은 인증 유형입니다.
토큰: 인증 유형의 사용자 인증 정보입니다.

인증 서버에 SSL/TLS 인증서가 필요하면 인증서와 비공개 키를 업로드합니다.