org.keycloak.social.microsoft.MicrosoftUserAttributeMapper クラス

org.keycloak.social.microsoft.MicrosoftUserAttributeMapper の継承関係図

org.keycloak.social.microsoft.MicrosoftUserAttributeMapper 連携図

公開メンバ関数
String []	getCompatibleProviders ()
String	getId ()
List< ProviderConfigProperty >	getConfigProperties ()
String	getDisplayCategory ()
String	getDisplayType ()
String	getHelpText ()
void	preprocessFederatedIdentity (KeycloakSession session, RealmModel realm, IdentityProviderMapperModel mapperModel, BrokeredIdentityContext context)
void	updateBrokeredUser (KeycloakSession session, RealmModel realm, UserModel user, IdentityProviderMapperModel mapperModel, BrokeredIdentityContext context)

静的公開メンバ関数
static void	storeUserProfileForMapper (BrokeredIdentityContext user, JsonNode profile, String provider)
static Object	getJsonValue (JsonNode baseNode, String fieldPath)

静的公開変数類
static final String	CONF_JSON_FIELD = "jsonField"
static final String	CONF_USER_ATTRIBUTE = "userAttribute"
static final String	CONTEXT_JSON_NODE = OIDCIdentityProvider.USER_INFO

静的限定公開メンバ関数
static Object	getJsonValue (IdentityProviderMapperModel mapperModel, BrokeredIdentityContext context)

静的限定公開変数類
static final Logger	logger = Logger.getLogger(AbstractJsonUserAttributeMapper.class)
static final Logger	LOGGER_DUMP_USER_PROFILE = Logger.getLogger("org.keycloak.social.user_profile_dump")

静的関数
	[static initializer]

静的非公開変数類
static final String []	cp = new String[] { MicrosoftIdentityProviderFactory.PROVIDER_ID }

詳解

User attribute mapper.

著者

Vlastimil Elias (velias at redhat dot com)

関数詳解

[static initializer]()

org.keycloak.broker.oidc.mappers.AbstractJsonUserAttributeMapper.[static initializer] ( )

inlinestaticpackageinherited

getCompatibleProviders()

String [] org.keycloak.social.microsoft.MicrosoftUserAttributeMapper.getCompatibleProviders ( )

inline

                                                 {
                return cp;
        }

getConfigProperties()

List<ProviderConfigProperty> org.keycloak.broker.oidc.mappers.AbstractJsonUserAttributeMapper.getConfigProperties ( )

inlineinherited

                                                                  {
                return configProperties;
        }

getDisplayCategory()

String org.keycloak.broker.oidc.mappers.AbstractJsonUserAttributeMapper.getDisplayCategory ( )

inlineinherited

                                           {
                return "Attribute Importer";
        }

getDisplayType()

String org.keycloak.broker.oidc.mappers.AbstractJsonUserAttributeMapper.getDisplayType ( )

inlineinherited

                                       {
                return "Attribute Importer";
        }

getHelpText()

String org.keycloak.broker.oidc.mappers.AbstractJsonUserAttributeMapper.getHelpText ( )

inlineinherited

                                    {
                return "Import user profile information if it exists in Social provider JSON data into the specified user attribute.";
        }

getId()

String org.keycloak.social.microsoft.MicrosoftUserAttributeMapper.getId ( )

inline

                              {
                return "microsoft-user-attribute-mapper";
        }

getJsonValue() [1/2]

static Object org.keycloak.broker.oidc.mappers.AbstractJsonUserAttributeMapper.getJsonValue ( IdentityProviderMapperModel  mapperModel, BrokeredIdentityContext  context  )

inlinestaticprotectedinherited

                                                                                                                       {

                String jsonField = mapperModel.getConfig().get(CONF_JSON_FIELD);
                if (jsonField == null || jsonField.trim().isEmpty()) {
                        logger.warnf("JSON field path is not configured for mapper %s", mapperModel.getName());
                        return null;
                }
                jsonField = jsonField.trim();

                if (jsonField.startsWith(JSON_PATH_DELIMITER) || jsonField.endsWith(JSON_PATH_DELIMITER) || jsonField.startsWith("[")) {
                        logger.warnf("JSON field path is invalid %s", jsonField);
                        return null;
                }

                JsonNode profileJsonNode = (JsonNode) context.getContextData().get(CONTEXT_JSON_NODE);

                Object value = getJsonValue(profileJsonNode, jsonField);

                if (value == null) {
                        logger.debugf("User profile JSON value '%s' is not available.", jsonField);
                }

                return value;
        }

getJsonValue() [2/2]

static Object org.keycloak.broker.oidc.mappers.AbstractJsonUserAttributeMapper.getJsonValue ( JsonNode  baseNode, String  fieldPath  )

inlinestaticinherited

                                                                               {
                logger.debug("Going to process JsonNode path " + fieldPath + " on data " + baseNode);
                if (baseNode != null) {

                        int idx = fieldPath.indexOf(JSON_PATH_DELIMITER);

                        String currentFieldName = fieldPath;
                        if (idx > 0) {
                                currentFieldName = fieldPath.substring(0, idx).trim();
                                if (currentFieldName.isEmpty()) {
                                        logger.debug("JSON path is invalid " + fieldPath);
                                        return null;
                                }
                        }

                        String currentNodeName = currentFieldName;
                        int arrayIndex = -1;
                        if (currentFieldName.endsWith("]")) {
                                int bi = currentFieldName.indexOf("[");
                                if (bi == -1) {
                                        logger.debug("Invalid array index construct in " + currentFieldName);
                                        return null;
                                }
                                try {
                                String is = currentFieldName.substring(bi+1, currentFieldName.length() - 1).trim();
                                        arrayIndex = Integer.parseInt(is);
                                } catch (Exception e) {
                                        logger.debug("Invalid array index construct in " + currentFieldName);
                                        return null;
                                }
                                currentNodeName = currentFieldName.substring(0,bi).trim();
                        }

                        JsonNode currentNode = baseNode.get(currentNodeName);
                        if (arrayIndex > -1 && currentNode.isArray()) {
                                logger.debug("Going to take array node at index " + arrayIndex);
                                currentNode = currentNode.get(arrayIndex);
                        }

                        if (currentNode == null) {
                                logger.debug("JsonNode not found for name " + currentFieldName);
                                return null;
                        }

                        if (idx < 0) {
                                if (currentNode.isArray()) {
                                        List<String> values = new ArrayList<>();
                                        for (JsonNode childNode : currentNode) {
                                                if (childNode.isTextual()) {
                                                        values.add(childNode.textValue());
                                                } else {
                                                        logger.warn("JsonNode in array is not text value " + childNode);
                                                }
                                        }
                                        if (values.isEmpty()) {
                                                return null;
                                        }
                                        return arrayIndex == idx? values : null;
                                }
                                if (!currentNode.isValueNode() || currentNode.isNull()) {
                                        logger.debug("JsonNode is not value node for name " + currentFieldName);
                                        return null;
                                }
                                String ret = currentNode.asText();
                                if (ret != null && !ret.trim().isEmpty())
                                        return ret.trim();
                        } else {
                                return getJsonValue(currentNode, fieldPath.substring(idx + 1));
                        }
                }
                return null;
        }

preprocessFederatedIdentity()

void org.keycloak.broker.oidc.mappers.AbstractJsonUserAttributeMapper.preprocessFederatedIdentity ( KeycloakSession  session, RealmModel  realm, IdentityProviderMapperModel  mapperModel, BrokeredIdentityContext  context  )

inlineinherited

                                                                                                                                                                     {
                String attribute = mapperModel.getConfig().get(CONF_USER_ATTRIBUTE);
                if (attribute == null || attribute.trim().isEmpty()) {
                        logger.warnf("Attribute is not configured for mapper %s", mapperModel.getName());
                        return;
                }
                attribute = attribute.trim();

                Object value = getJsonValue(mapperModel, context);
                if (value != null) {
                        if (value instanceof List) {
                                context.setUserAttribute(attribute, (List<String>) value);
                        } else {
                                context.setUserAttribute(attribute, value.toString());
                        }
                }
        }

storeUserProfileForMapper()

static void org.keycloak.broker.oidc.mappers.AbstractJsonUserAttributeMapper.storeUserProfileForMapper ( BrokeredIdentityContext  user, JsonNode  profile, String  provider  )

inlinestaticinherited

Store used profile JsonNode into user context for later use by this mapper. Profile data are dumped into special logger if enabled also to allow investigation of the structure.

引数

user	context to store profile data into
profile	to store into context
provider	identification of social provider to be used in log dump

参照

preprocessFederatedIdentity(KeycloakSession, RealmModel, IdentityProviderMapperModel, BrokeredIdentityContext)

BrokeredIdentityContext::getContextData()

                                                                                                                      {
                user.getContextData().put(AbstractJsonUserAttributeMapper.CONTEXT_JSON_NODE, profile);
                if (LOGGER_DUMP_USER_PROFILE.isDebugEnabled())
                        LOGGER_DUMP_USER_PROFILE.debug("User Profile JSON Data for provider "+provider+": " + profile);
        }

updateBrokeredUser()

void org.keycloak.broker.oidc.mappers.AbstractJsonUserAttributeMapper.updateBrokeredUser ( KeycloakSession  session, RealmModel  realm, UserModel  user, IdentityProviderMapperModel  mapperModel, BrokeredIdentityContext  context  )

inlineinherited

                                                                                                                                                                            {
                // we do not update user profile from social provider
        }

メンバ詳解

CONF_JSON_FIELD

final String org.keycloak.broker.oidc.mappers.AbstractJsonUserAttributeMapper.CONF_JSON_FIELD = "jsonField"

staticinherited

Config param where name of mapping source JSON User Profile field is stored.

CONF_USER_ATTRIBUTE

final String org.keycloak.broker.oidc.mappers.AbstractJsonUserAttributeMapper.CONF_USER_ATTRIBUTE = "userAttribute"

staticinherited

Config param where name of mapping target USer attribute is stored.

CONTEXT_JSON_NODE

final String org.keycloak.broker.oidc.mappers.AbstractJsonUserAttributeMapper.CONTEXT_JSON_NODE = OIDCIdentityProvider.USER_INFO

staticinherited

Key in BrokeredIdentityContext#getContextData() where JsonNode with user profile is stored.

cp

final String [] org.keycloak.social.microsoft.MicrosoftUserAttributeMapper.cp = new String[] { MicrosoftIdentityProviderFactory.PROVIDER_ID }

staticprivate

logger

final Logger org.keycloak.broker.oidc.mappers.AbstractJsonUserAttributeMapper.logger = Logger.getLogger(AbstractJsonUserAttributeMapper.class)

staticprotectedinherited

LOGGER_DUMP_USER_PROFILE

final Logger org.keycloak.broker.oidc.mappers.AbstractJsonUserAttributeMapper.LOGGER_DUMP_USER_PROFILE = Logger.getLogger("org.keycloak.social.user_profile_dump")

staticprotectedinherited

---

このクラス詳解は次のファイルから抽出されました:

• D:/AppData/doxygen/keycloak/rest-service/src/services/src/main/java/org/keycloak/social/microsoft/MicrosoftUserAttributeMapper.java