You are viewing documentation for version 2 of the AWS SDK for Ruby. Version 3 documentation can be found here.

Class: Aws::CodePipeline::Types::WebhookDefinition

Inherits:
Struct
  • Object
show all
Defined in:
(unknown)

Overview

Note:

When passing WebhookDefinition as input to an Aws::Client method, you can use a vanilla Hash:

{
  name: "WebhookName", # required
  target_pipeline: "PipelineName", # required
  target_action: "ActionName", # required
  filters: [ # required
    {
      json_path: "JsonPath", # required
      match_equals: "MatchEquals",
    },
  ],
  authentication: "GITHUB_HMAC", # required, accepts GITHUB_HMAC, IP, UNAUTHENTICATED
  authentication_configuration: { # required
    allowed_ip_range: "WebhookAuthConfigurationAllowedIPRange",
    secret_token: "WebhookAuthConfigurationSecretToken",
  },
}

Represents information about a webhook and its definition.

Returned by:

Instance Attribute Summary collapse

Instance Attribute Details

#authenticationString

Supported options are GITHUB_HMAC, IP and UNAUTHENTICATED.

  • GITHUB_HMAC implements the authentication scheme described here: https://developer.github.com/webhooks/securing/

  • IP will reject webhooks trigger requests unless they originate from an IP within the IP range whitelisted in the authentication configuration.

  • UNAUTHENTICATED will accept all webhook trigger requests regardless of origin.

    Possible values:

    • GITHUB_HMAC
    • IP
    • UNAUTHENTICATED

Returns:

  • (String)

    Supported options are GITHUB_HMAC, IP and UNAUTHENTICATED.

#authentication_configurationTypes::WebhookAuthConfiguration

Properties that configure the authentication applied to incoming webhook trigger requests. The required properties depend on the authentication type. For GITHUB_HMAC, only the SecretToken property must be set. For IP, only the AllowedIPRange property must be set to a valid CIDR range. For UNAUTHENTICATED, no properties can be set.

Returns:

#filtersArray<Types::WebhookFilterRule>

A list of rules applied to the body/payload sent in the POST request to a webhook URL. All defined rules must pass for the request to be accepted and the pipeline started.

Returns:

  • (Array<Types::WebhookFilterRule>)

    A list of rules applied to the body/payload sent in the POST request to a webhook URL.

#nameString

The name of the webhook.

Returns:

  • (String)

    The name of the webhook.

#target_actionString

The name of the action in a pipeline you want to connect to the webhook. The action must be from the source (first) stage of the pipeline.

Returns:

  • (String)

    The name of the action in a pipeline you want to connect to the webhook.

#target_pipelineString

The name of the pipeline you want to connect to the webhook.

Returns:

  • (String)

    The name of the pipeline you want to connect to the webhook.