ScriptProtocolMapperArgs

data class ScriptProtocolMapperArgs(val clientId: Output<String>? = null, val clientScopeId: Output<String>? = null, val friendlyName: Output<String>? = null, val name: Output<String>? = null, val realmId: Output<String>? = null, val samlAttributeName: Output<String>? = null, val samlAttributeNameFormat: Output<String>? = null, val script: Output<String>? = null, val singleValueAttribute: Output<Boolean>? = null) : ConvertibleToJava<ScriptProtocolMapperArgs>

Allows for creating and managing script protocol mappers for SAML clients within Keycloak. Script protocol mappers evaluate a JavaScript function to produce an attribute value based on context information. Protocol mappers can be defined for a single client, or they can be defined for a client scope which can be shared between multiple different clients.

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as keycloak from "@pulumi/keycloak";
const realm = new keycloak.Realm("realm", {
realm: "my-realm",
enabled: true,
});
const samlClient = new keycloak.saml.Client("saml_client", {
realmId: realm.id,
clientId: "saml-client",
name: "saml-client",
});
const samlScriptMapper = new keycloak.saml.ScriptProtocolMapper("saml_script_mapper", {
realmId: realm.id,
clientId: samlClient.id,
name: "script-mapper",
script: "exports = 'foo';",
samlAttributeName: "displayName",
samlAttributeNameFormat: "Unspecified",
});
import pulumi
import pulumi_keycloak as keycloak
realm = keycloak.Realm("realm",
realm="my-realm",
enabled=True)
saml_client = keycloak.saml.Client("saml_client",
realm_id=realm.id,
client_id="saml-client",
name="saml-client")
saml_script_mapper = keycloak.saml.ScriptProtocolMapper("saml_script_mapper",
realm_id=realm.id,
client_id=saml_client.id,
name="script-mapper",
script="exports = 'foo';",
saml_attribute_name="displayName",
saml_attribute_name_format="Unspecified")
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Keycloak = Pulumi.Keycloak;
return await Deployment.RunAsync(() =>
{
var realm = new Keycloak.Realm("realm", new()
{
RealmName = "my-realm",
Enabled = true,
});
var samlClient = new Keycloak.Saml.Client("saml_client", new()
{
RealmId = realm.Id,
ClientId = "saml-client",
Name = "saml-client",
});
var samlScriptMapper = new Keycloak.Saml.ScriptProtocolMapper("saml_script_mapper", new()
{
RealmId = realm.Id,
ClientId = samlClient.Id,
Name = "script-mapper",
Script = "exports = 'foo';",
SamlAttributeName = "displayName",
SamlAttributeNameFormat = "Unspecified",
});
});
package main
import (
"github.com/pulumi/pulumi-keycloak/sdk/v5/go/keycloak"
"github.com/pulumi/pulumi-keycloak/sdk/v5/go/keycloak/saml"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
realm, err := keycloak.NewRealm(ctx, "realm", &keycloak.RealmArgs{
Realm: pulumi.String("my-realm"),
Enabled: pulumi.Bool(true),
})
if err != nil {
return err
}
samlClient, err := saml.NewClient(ctx, "saml_client", &saml.ClientArgs{
RealmId: realm.ID(),
ClientId: pulumi.String("saml-client"),
Name: pulumi.String("saml-client"),
})
if err != nil {
return err
}
_, err = saml.NewScriptProtocolMapper(ctx, "saml_script_mapper", &saml.ScriptProtocolMapperArgs{
RealmId: realm.ID(),
ClientId: samlClient.ID(),
Name: pulumi.String("script-mapper"),
Script: pulumi.String("exports = 'foo';"),
SamlAttributeName: pulumi.String("displayName"),
SamlAttributeNameFormat: pulumi.String("Unspecified"),
})
if err != nil {
return err
}
return nil
})
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.keycloak.Realm;
import com.pulumi.keycloak.RealmArgs;
import com.pulumi.keycloak.saml.Client;
import com.pulumi.keycloak.saml.ClientArgs;
import com.pulumi.keycloak.saml.ScriptProtocolMapper;
import com.pulumi.keycloak.saml.ScriptProtocolMapperArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var realm = new Realm("realm", RealmArgs.builder()
.realm("my-realm")
.enabled(true)
.build());
var samlClient = new Client("samlClient", ClientArgs.builder()
.realmId(realm.id())
.clientId("saml-client")
.name("saml-client")
.build());
var samlScriptMapper = new ScriptProtocolMapper("samlScriptMapper", ScriptProtocolMapperArgs.builder()
.realmId(realm.id())
.clientId(samlClient.id())
.name("script-mapper")
.script("exports = 'foo';")
.samlAttributeName("displayName")
.samlAttributeNameFormat("Unspecified")
.build());
}
}
resources:
realm:
type: keycloak:Realm
properties:
realm: my-realm
enabled: true
samlClient:
type: keycloak:saml:Client
name: saml_client
properties:
realmId: ${realm.id}
clientId: saml-client
name: saml-client
samlScriptMapper:
type: keycloak:saml:ScriptProtocolMapper
name: saml_script_mapper
properties:
realmId: ${realm.id}
clientId: ${samlClient.id}
name: script-mapper
script: exports = 'foo';
samlAttributeName: displayName
samlAttributeNameFormat: Unspecified

Import

Protocol mappers can be imported using one of the following formats:

  • Client: {{realm_id}}/client/{{client_keycloak_id}}/{{protocol_mapper_id}}

  • Client Scope: {{realm_id}}/client-scope/{{client_scope_keycloak_id}}/{{protocol_mapper_id}} Example: bash

$ pulumi import keycloak:saml/scriptProtocolMapper:ScriptProtocolMapper saml_script_mapper my-realm/client/a7202154-8793-4656-b655-1dd18c181e14/71602afa-f7d1-4788-8c49-ef8fd00af0f4
$ pulumi import keycloak:saml/scriptProtocolMapper:ScriptProtocolMapper saml_script_mapper my-realm/client-scope/b799ea7e-73ee-4a73-990a-1eafebe8e20a/71602afa-f7d1-4788-8c49-ef8fd00af0f4

Constructors

Link copied to clipboard
constructor(clientId: Output<String>? = null, clientScopeId: Output<String>? = null, friendlyName: Output<String>? = null, name: Output<String>? = null, realmId: Output<String>? = null, samlAttributeName: Output<String>? = null, samlAttributeNameFormat: Output<String>? = null, script: Output<String>? = null, singleValueAttribute: Output<Boolean>? = null)

Properties

Link copied to clipboard
val clientId: Output<String>? = null

The client this protocol mapper should be attached to. Conflicts with client_scope_id. One of client_id or client_scope_id must be specified.

Link copied to clipboard
val clientScopeId: Output<String>? = null

The client scope this protocol mapper should be attached to. Conflicts with client_id. One of client_id or client_scope_id must be specified.

Link copied to clipboard
val friendlyName: Output<String>? = null

An optional human-friendly name for this attribute.

Link copied to clipboard
val name: Output<String>? = null

The display name of this protocol mapper in the GUI.

Link copied to clipboard
val realmId: Output<String>? = null

The realm this protocol mapper exists within.

Link copied to clipboard
val samlAttributeName: Output<String>? = null

The name of the SAML attribute.

Link copied to clipboard
val samlAttributeNameFormat: Output<String>? = null

The SAML attribute Name Format. Can be one of Unspecified, Basic, or URI Reference.

Link copied to clipboard
val script: Output<String>? = null

JavaScript code to compute the attribute value.

Link copied to clipboard
val singleValueAttribute: Output<Boolean>? = null

When true, all values will be stored under one attribute with multiple attribute values. Defaults to true.

Functions

Link copied to clipboard
open override fun toJava(): ScriptProtocolMapperArgs