Top / Amazon Web Service / AWS Amazon Pinpoint / APNS Sandbox Channel

AWS Amazon Pinpoint APNS Sandbox Channel

This page shows how to write Terraform and CloudFormation for Amazon Pinpoint APNS Sandbox Channel and write them securely.

terraform-logo

Review your .tf file for AWS best practices

Shisho Cloud, our free checker to make sure your Terraform configuration follows best practices, is available (beta).

aws_pinpoint_apns_sandbox_channel (Terraform)

The APNS Sandbox Channel in Amazon Pinpoint can be configured in Terraform with the resource name aws_pinpoint_apns_sandbox_channel. The following sections describe 1 example of how to use the resource and its parameters.

Example Usage from GitHub

main.tf#L7
resource "aws_pinpoint_apns_sandbox_channel" "this" {
  application_id                = var.application_id
  bundle_id                     = var.bundle_id
  certificate                   = var.certificate
  default_authentication_method = var.default_authentication_method
  enabled                       = var.enabled

Review your Terraform file for AWS best practices

Shisho Cloud, our free checker to make sure your Terraform configuration follows best practices, is available (beta).

Parameters

>> from Terraform Registry

Explanation in Terraform Registry

Provides a Pinpoint APNs Sandbox Channel resource.

Note: All arguments, including certificates and tokens, will be stored in the raw state as plain-text. Read more about sensitive data in state.

>> from Terraform Registry

AWS::Pinpoint::APNSSandboxChannel (CloudFormation)

The APNSSandboxChannel in Pinpoint can be configured in CloudFormation with the resource name AWS::Pinpoint::APNSSandboxChannel. The following sections describe 8 examples of how to use the resource and its parameters.

Example Usage from GitHub

aws-pinpoint-apnssandboxchannel.yaml#L9
    Type: AWS::Pinpoint::APNSSandboxChannel
    Properties:
      ApplicationId: !Ref applicationid
pinpoint_apnssandboxchannel_private_key_as_a_literal_in_plaintext.yaml#L8
    Type: AWS::Pinpoint::APNSSandboxChannel
    Properties:
      PrivateKey: b@dP@$sW0rD
      ApplicationId: !Ref PinpointApp
pinpoint_apnssandboxchannel_private_key_not_set.yaml#L8
    Type: AWS::Pinpoint::APNSSandboxChannel
    Properties:
      ApplicationId: !Ref PinpointApp
pinpoint_apnssandboxchannel_token_key_not_set.yaml#L8
    Type: AWS::Pinpoint::APNSSandboxChannel
    Properties:
      ApplicationId: !Ref PinpointApp
pinpoint_apnssandboxchannel_token_key_as_a_literal_in_plaintext.yaml#L8
    Type: AWS::Pinpoint::APNSSandboxChannel
    Properties:
      TokenKey: b@d0@u7H70K3n
      ApplicationId: !Ref PinpointApp
awsResouceIconMatches.json#L604
        "resourceType": "AWS::Pinpoint::APNSSandboxChannel",
        "filePath": null
      },
      {
        "resourceType": "AWS::Pinpoint::ADMChannel",
        "filePath": null
PinpointAPNSSandboxChannelSpecification.json#L3
    "AWS::Pinpoint::APNSSandboxChannel": {
      "Documentation": "http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-pinpoint-apnssandboxchannel.html",
      "Properties": {
        "BundleId": {
          "Required": false,
          "Documentation": "http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-pinpoint-apnssandboxchannel.html#cfn-pinpoint-apnssandboxchannel-bundleid",
template.json#L1855
    "AWS::Pinpoint::APNSSandboxChannel": {
      "Type": "AWS::Pinpoint::APNSSandboxChannel",
      "Properties": {}
    },
    "AWS::Pinpoint::ADMChannel": {
      "Type": "AWS::Pinpoint::ADMChannel",

Parameters

ApplicationId The unique identifier for the Amazon Pinpoint application that the APNs sandbox channel applies to.
Required: Yes
Type: String
Update requires: Replacement

BundleId The bundle identifier that's assigned to your iOS app. This identifier is used for APNs tokens.
Required: No
Type: String
Update requires: No interruption

Certificate The APNs client certificate that you received from Apple. Specify this value if you want Amazon Pinpoint to communicate with APNs by using an APNs certificate.
Required: No
Type: String
Update requires: No interruption

DefaultAuthenticationMethod The default authentication method that you want Amazon Pinpoint to use when authenticating with APNs. Valid options are key or certificate.
Required: No
Type: String
Update requires: No interruption

Enabled Specifies whether to enable the APNs Sandbox channel for the Amazon Pinpoint application.
Required: No
Type: Boolean
Update requires: No interruption

PrivateKey The private key for the APNs client certificate that you want Amazon Pinpoint to use to communicate with APNs.
Required: No
Type: String
Update requires: No interruption

TeamId The identifier that's assigned to your Apple Developer Account team. This identifier is used for APNs tokens.
Required: No
Type: String
Update requires: No interruption

TokenKey The authentication key to use for APNs tokens.
Required: No
Type: String
Update requires: No interruption

TokenKeyId The key identifier that's assigned to your APNs signing key. Specify this value if you want Amazon Pinpoint to communicate with APNs by using APNs tokens.
Required: No
Type: String
Update requires: No interruption

>> from AWS CloudFormation Documentation

Explanation in CloudFormation Registry

A channel is a type of platform that you can deliver messages to. You can use the APNs sandbox channel to send push notification messages to the sandbox environment of the Apple Push Notification service (APNs). Before you can use Amazon Pinpoint to send notifications to the APNs sandbox environment, you have to enable the APNs sandbox channel for an Amazon Pinpoint application.

The APNSSandboxChannel resource represents the status and authentication settings of the APNs sandbox channel for an application.

>> from AWS CloudFormation Documentation

The Other Related AWS Amazon Pinpoint Resources

Frequently asked questions

What is AWS Amazon Pinpoint APNS Sandbox Channel?

AWS Amazon Pinpoint APNS Sandbox Channel is a resource for Amazon Pinpoint of Amazon Web Service. Settings can be wrote in Terraform and CloudFormation.

Where can I find the example code for the AWS Amazon Pinpoint APNS Sandbox Channel?

For Terraform, the niveklabs/aws source code example is useful. See the Terraform Example section for further details.

For CloudFormation, the rubyonrails3/cfn-rules, stelligent/cfn_nag and stelligent/cfn_nag source code examples are useful. See the CloudFormation Example section for further details.

security-icon

Automate config file reviews on your commits

Fix issues in your infrastructure as code with auto-generated patches.

Table of Contents