Automation을 위한 웹후크 통합 생성 - AWS Systems Manager
통합 생성(콘솔)통합 생성(명령줄)통합을 위한 웹후크 생성

Automation을 위한 웹후크 통합 생성

자동화 중 웹후크를 사용하여 메시지를 전송하려면 통합을 생성합니다. 실행서에서 aws:invokeWebhook 작업을 사용하여 자동화 중 통합을 호출할 수 있습니다. 웹후크를 아직 생성하지 않은 경우 통합을 위한 웹후크 생성 섹션을 참조하세요. aws:invokeWebhook 작업에 대한 자세한 내용은 aws:invokeWebhook - Automation 웹후크 통합 호출 섹션을 참조하세요.

다음 절차에서 볼 수 있듯이 Systems Manager 자동화 콘솔이나 선호하는 명령줄 도구를 사용하여 통합을 생성할 수 있습니다.

통합 생성(콘솔)

Automation을 위한 통합 생성(콘솔)

  1. AWS Systems Manager 콘솔(https://console.aws.amazon.com/systems-manager/)을 엽니다.

  2. 왼쪽 탐색 창에서 Automation을 선택합니다.

  3. 통합(Integrations) 탭을 선택합니다.

  4. 통합 추가(Add integration)를 선택하고 웹후크(Webhook)를 선택합니다.

  5. 통합에 포함할 필수 값과 선택적 값을 입력합니다.

  6. 추가(Add)를 선택하여 통합을 생성합니다.

통합 생성(명령줄)

명령줄 도구를 사용하여 통합을 생성하려면 통합에 필요한 SecureString 파라미터를 생성해야 합니다. Automation은 Systems Manager의 기능인 Parameter Store에서 예약된 네임스페이스를 사용하여 통합에 대한 정보를 저장합니다. AWS Management Console을 사용하여 통합을 생성하는 경우 Automation이 이 프로세스를 자동으로 처리합니다. 네임스페이스 다음에 생성하려는 통합 유형을 지정하고 통합 이름을 지정해야 합니다. 현재 Automation은 webhook 유형 통합을 지원합니다.

webhook 유형 통합에 지원되는 필드는 다음과 같습니다.

  • 설명

  • 헤더

  • payload

  • URL

시작하기 전 준비 사항

아직 하지 않은 경우 AWS Command Line Interface(AWS CLI) 또는 AWS Tools for PowerShell을 설치하고 구성합니다. 자세한 내용은 최신 버전의 AWS CLI 설치 또는 업데이트 및 AWS Tools for PowerShell 설치를 참조하세요.

Automation을 위한 통합 생성(명령줄)

  • 다음 명령을 실행하여 통합에 필요한 SecureString 파라미터를 생성합니다. 각 example resource placeholder를 사용자의 정보로 바꿉니다. /d9d01087-4a3f-49e0-b0b4-d568d7826553/ssm/integrations/webhook/ 네임스페이스는 통합을 위해 Parameter Store에 예약되어 있습니다. 파라미터 이름은 이 네임스페이스 다음에 통합 이름을 사용해야 합니다. 예: /d9d01087-4a3f-49e0-b0b4-d568d7826553/ssm/integrations/webhook/myWebhookIntegration.

    Linux & macOS
    aws ssm put-parameter \
    --name "/d9d01087-4a3f-49e0-b0b4-d568d7826553/ssm/integrations/webhook/myWebhookIntegration" \
    --type "SecureString" \
    --data-type "aws:ssm:integration" \
    --value '{"description": "My first webhook integration for Automation.", "url": "myWebHookURL"}'
    Windows
    aws ssm put-parameter ^
    --name "/d9d01087-4a3f-49e0-b0b4-d568d7826553/ssm/integrations/webhook/myWebhookIntegration" ^
    --type "SecureString" ^
    --data-type "aws:ssm:integration" ^
    --value  "{\"description\":\"My first webhook integration for Automation.\",\"url\":\"myWebHookURL\"}"
    PowerShell
    Write-SSMParameter `
    -Name "/d9d01087-4a3f-49e0-b0b4-d568d7826553/ssm/integrations/webhook/myWebhookIntegration" `
    -Type "SecureString"
    -DataType "aws:ssm:integration"
    -Value '{"description": "My first webhook integration for Automation.", "url": "myWebHookURL"}'

통합을 위한 웹후크 생성

공급자와 웹후크를 생성할 때는 다음 사항에 유의하세요.

  • 프로토콜은 HTTPS여야 합니다.

  • 사용자 정의 요청 헤더가 지원됩니다.

  • 기본 요청 본문을 지정할 수 있습니다.

  • aws:invokeWebhook 작업을 사용하여 통합을 호출할 때 기본 요청 본문을 재정의할 수 있습니다.