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:

See Also:

Instance Attribute Summary collapse

Instance Attribute Details

#authentication ⇒ String

Supported options are GITHUB_HMAC, IP, and UNAUTHENTICATED.

  • For information about the authentication scheme implemented by GITHUB_HMAC, see Securing your webhooks on the GitHub Developer website.

  • IP rejects webhooks trigger requests unless they originate from an IP address in the IP range whitelisted in the authentication configuration.

  • UNAUTHENTICATED accepts all webhook trigger requests regardless of origin.

Returns:

  • (String) —

    Supported options are GITHUB_HMAC, IP, and UNAUTHENTICATED.

#authentication_configuration ⇒ Types::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 SecretTokenproperty must be set. For IP, only the AllowedIPRangeproperty must be set to a valid CIDR range. For UNAUTHENTICATED, no properties can be set.

Returns:

#filters ⇒ Array<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.

#name ⇒ String

The name of the webhook.

Returns:

  • (String) —

    The name of the webhook.

#target_action ⇒ String

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_pipeline ⇒ String

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.