> **Experimental**
>
> `@aws-cdk/aws-mediapackagev2-alpha` is an [**experimental**](/stability) (alpha) package: its API may change in any release, without a major version bump.
# IsmEncryption

Encryption configuration for ISM (Microsoft Smooth Streaming) segments.

ISM only supports CENC encryption with PlayReady DRM.
Audio and video presets are always SHARED.

Use `IsmEncryption.speke()` to create an instance.

Extends: [EncryptionConfiguration](/cdk/api/v2/docs/@aws-cdk_aws-mediapackagev2-alpha.EncryptionConfiguration.html) › IsmEncryption
Obtainable from: IsmEncryption.speke

- Stability: [Experimental](/cdk/api/stability.html)
- Source: [`lib/endpoint.ts`](https://github.com/aws/aws-cdk/blob/v2.277.0/packages/@aws-cdk/aws-mediapackagev2-alpha/lib/endpoint.ts#L2308)

## Example

TypeScript:

```ts
declare const channel: Channel;
declare const spekeRole: iam.IRole;

new OriginEndpoint(this, 'IsmEndpoint', {
  channel,
  segment: Segment.ism({
    encryption: IsmEncryption.speke({
      resourceId: 'my-content-id',
      url: 'https://example.com/speke',
      role: spekeRole,
    }),
  }),
  manifests: [Manifest.mss({ manifestName: 'index' })],
});
```

Python:

```python
# channel: Channel
# speke_role: iam.IRole

OriginEndpoint(self, "IsmEndpoint",
    channel=channel,
    segment=Segment.ism(
        encryption=IsmEncryption.speke(
            resource_id="my-content-id",
            url="https://example.com/speke",
            role=speke_role
        )
    ),
    manifests=[Manifest.mss(manifest_name="index")]
)
```

Java:

```java
Channel channel;
IRole spekeRole;

OriginEndpoint.Builder.create(this, "IsmEndpoint")
        .channel(channel)
        .segment(Segment.ism(IsmSegmentProps.builder()
                .encryption(IsmEncryption.speke(IsmSpekeEncryptionProps.builder()
                        .resourceId("my-content-id")
                        .url("https://example.com/speke")
                        .role(spekeRole)
                        .build()))
                .build()))
        .manifests(List.of(Manifest.mss(MssManifestConfiguration.builder().manifestName("index").build())))
        .build();
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.AWS.MediaPackageV2.Alpha
Channel channel;
IRole spekeRole;

new OriginEndpoint(this, "IsmEndpoint", new OriginEndpointProps {
    Channel = channel,
    Segment = Segment.Ism(new IsmSegmentProps {
        Encryption = IsmEncryption.Speke(new IsmSpekeEncryptionProps {
            ResourceId = "my-content-id",
            Url = "https://example.com/speke",
            Role = spekeRole
        })
    }),
    Manifests = new [] { Manifest.Mss(new MssManifestConfiguration { ManifestName = "index" }) }
});
```

Golang:

```go
// Install: go get github.com/aws/aws-cdk-go/awsmediapackagev2alpha/v2
var channel Channel
var spekeRole IRole

awsmediapackagev2alpha.NewOriginEndpoint(this, jsii.String("IsmEndpoint"), &OriginEndpointProps{
	Channel: Channel,
	Segment: awsmediapackagev2alpha.Segment_Ism(&IsmSegmentProps{
		Encryption: awsmediapackagev2alpha.IsmEncryption_Speke(&IsmSpekeEncryptionProps{
			ResourceId: jsii.String("my-content-id"),
			Url: jsii.String("https://example.com/speke"),
			Role: spekeRole,
		}),
	}),
	Manifests: []Manifest{
		awsmediapackagev2alpha.Manifest_Mss(&MssManifestConfiguration{
			ManifestName: jsii.String("index"),
		}),
	},
})
```

## Methods

- `speke(props: IsmSpekeEncryptionProps): IsmEncryption // chainable` (static) — Create a SPEKE-based encryption configuration for ISM segments.
