UserPropertyProtocolMapperArgs

data class UserPropertyProtocolMapperArgs(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 userProperty: Output<String>? = null) : ConvertibleToJava<UserPropertyProtocolMapperArgs>

Allows for creating and managing user property protocol mappers for SAML clients within Keycloak. SAML user property protocol mappers allow you to map properties of the Keycloak user model to an attribute in a SAML assertion. 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 samlUserPropertyMapper = new keycloak.saml.UserPropertyProtocolMapper("saml_user_property_mapper", {
realmId: realm.id,
clientId: samlClient.id,
name: "email-user-property-mapper",
userProperty: "email",
samlAttributeName: "email",
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_user_property_mapper = keycloak.saml.UserPropertyProtocolMapper("saml_user_property_mapper",
realm_id=realm.id,
client_id=saml_client.id,
name="email-user-property-mapper",
user_property="email",
saml_attribute_name="email",
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 samlUserPropertyMapper = new Keycloak.Saml.UserPropertyProtocolMapper("saml_user_property_mapper", new()
{
RealmId = realm.Id,
ClientId = samlClient.Id,
Name = "email-user-property-mapper",
UserProperty = "email",
SamlAttributeName = "email",
SamlAttributeNameFormat = "Unspecified",
});
});
package main
import (
"github.com/pulumi/pulumi-keycloak/sdk/v6/go/keycloak"
"github.com/pulumi/pulumi-keycloak/sdk/v6/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.NewUserPropertyProtocolMapper(ctx, "saml_user_property_mapper", &saml.UserPropertyProtocolMapperArgs{
RealmId: realm.ID(),
ClientId: samlClient.ID(),
Name: pulumi.String("email-user-property-mapper"),
UserProperty: pulumi.String("email"),
SamlAttributeName: pulumi.String("email"),
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.UserPropertyProtocolMapper;
import com.pulumi.keycloak.saml.UserPropertyProtocolMapperArgs;
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 samlUserPropertyMapper = new UserPropertyProtocolMapper("samlUserPropertyMapper", UserPropertyProtocolMapperArgs.builder()
.realmId(realm.id())
.clientId(samlClient.id())
.name("email-user-property-mapper")
.userProperty("email")
.samlAttributeName("email")
.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
samlUserPropertyMapper:
type: keycloak:saml:UserPropertyProtocolMapper
name: saml_user_property_mapper
properties:
realmId: ${realm.id}
clientId: ${samlClient.id}
name: email-user-property-mapper
userProperty: email
samlAttributeName: email
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/userPropertyProtocolMapper:UserPropertyProtocolMapper saml_user_property_mapper my-realm/client/a7202154-8793-4656-b655-1dd18c181e14/71602afa-f7d1-4788-8c49-ef8fd00af0f4
$ pulumi import keycloak:saml/userPropertyProtocolMapper:UserPropertyProtocolMapper saml_user_property_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, userProperty: Output<String>? = 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 userProperty: Output<String>? = null

The property of the Keycloak user model to map.

Functions

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