{"id":72010,"date":"2025-11-25T15:37:55","date_gmt":"2025-11-25T15:37:55","guid":{"rendered":"https:\/\/www.applivery.com\/?post_type=docs&p=72010"},"modified":"2025-11-25T16:31:29","modified_gmt":"2025-11-25T16:31:29","password":"","slug":"scim-attributes-mapping","status":"publish","type":"docs","link":"https:\/\/www.applivery.com\/pt-br\/docs\/platform\/integrations\/platform\/sso\/saml\/scim-attributes-mapping\/","title":{"rendered":"SCIM Attributes Mapping"},"content":{"rendered":"\t\t
\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t
\n\n\t\t\t\t\t\tNote<\/span>\n\t\t\t\n\t\t\t\t\t\tNote that this is a premium feature that might not be available in your current plan.
\n\nCheck the availability in our pricing page.<\/a><\/span>\n\t\t\t\n\t\t\t\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\tWhen receiving user information through SCIM, the data is often organized across multiple schemas. To keep this information consistent, usable, and accessible, Applivery can map specific SCIM attributes into the user\u2019s metadata<\/code> field.\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t
\n\t\t\t\t\t

Understanding SCIM Attribute Storage\n<\/h2>\t\t\t\t<\/div>\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\tAll mappable SCIM fields are automatically stored in an internal object called attributesHistory<\/code>. This object tracks every attribute received from SCIM, whether or not it is currently mapped to metadata.\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t
\n\t\t\t\t\t

SCIM Attributes History\n<\/h3>\t\t\t\t<\/div>\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\tThe attributesHistory<\/code> object contains all SCIM attributes in the following structure:\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t
\n\t\t\t\t\t\t\t
\n\t\t\t
\n\t\t\t\t\n\t\t\t\t\ttype IProviderSCIMAttributesHistory = {\n  namespace: string\n  key: string\n}<\/xmp>\n\t\t\t\t<\/code>\n\t\t\t<\/pre>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-b531d2f elementor-widget elementor-widget-text-editor\" data-id=\"b531d2f\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t\t\t\t\t\t<p>This object is populated automatically with all attributes provided in SCIM requests. Its purpose is to serve as a complete record of any field that can potentially be mapped.<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-6212391 elementor-widget elementor-widget-heading\" data-id=\"6212391\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t\t<h3 class=\"elementor-heading-title elementor-size-default\">Custom Attribute Mapping\n<\/h3>\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-8853842 elementor-widget elementor-widget-text-editor\" data-id=\"8853842\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t\t\t\t\t\t<p>To map SCIM fields into the user\u2019s metadata, you can define a custom mapping through the <code>mappedAttributes<\/code> property in the SCIM configuration model.<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-2b25a8c elementor-widget elementor-widget-code-highlight\" data-id=\"2b25a8c\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"code-highlight.default\">\n\t\t\t\t\t\t\t<div class=\"prismjs-default copy-to-clipboard \">\n\t\t\t<pre data-line=\"\" class=\"highlight-height language-javascript line-numbers\">\n\t\t\t\t<code readonly=\"true\" class=\"language-javascript\">\n\t\t\t\t\t<xmp>type IProviderSCIMCustomAttributes = {\n  name: string\n  attributes?: {\n    namespace?: string\n    key: string\n  }[]\n}<\/xmp>\n\t\t\t\t<\/code>\n\t\t\t<\/pre>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-9238e10 elementor-widget elementor-widget-text-editor\" data-id=\"9238e10\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t\t\t\t\t\t<p>Each mapping entry supports the following fields:<\/p><ul><li><strong>Name<\/strong>: The key under which the mapped value will be stored inside the user\u2019s metadata.<\/li><li><strong>Attributes<\/strong>: A list of SCIM attributes (optionally specifying their namespace\/schema) that will be used to generate this metadata value.<\/li><\/ul>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-1d7e5c4 elementor-alert-info elementor-widget elementor-widget-alert\" data-id=\"1d7e5c4\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"alert.default\">\n\t\t\t\t\t\t\t<div class=\"elementor-alert\" role=\"alert\">\n\n\t\t\t\t\t\t<span class=\"elementor-alert-title\">Note<\/span>\n\t\t\t\n\t\t\t\t\t\t<span class=\"elementor-alert-description\">For guidance on defining custom attributes inside your Identity Provider (IdP), refer to the <a href=\"https:\/\/www.applivery.com\/docs\/platform\/integrations\/platform\/sso\/saml\/scim-attribute-creation-and-assignment-in-okta\/\">following article in our documentation<\/a>.<\/span>\n\t\t\t\n\t\t\t\t\t\t<button type=\"button\" class=\"elementor-alert-dismiss\" aria-label=\"Dispensar este alerta.\">\n\t\t\t\t\t\t\t\t\t<span aria-hidden=\"true\">&times;<\/span>\n\t\t\t\t\t\t\t<\/button>\n\t\t\t\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-a2d49c2 elementor-widget elementor-widget-heading\" data-id=\"a2d49c2\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t\t<h3 class=\"elementor-heading-title elementor-size-default\">Resolution rules\n<\/h3>\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-0922903 elementor-widget elementor-widget-text-editor\" data-id=\"0922903\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t\t\t\t\t\t<p>When resolving which SCIM value to map into <code>metadata<\/code>, Applivery follows these rules:<\/p>\n<ol>\n \t<li>If a namespace is specified, the system searches for the SCIM attribute inside that exact namespace\/schema.<\/li>\n \t<li>If no namespace is defined, the system maps the first matching attribute key found in any schema.<\/li>\n \t<li>When a SCIM payload includes a value for a mapped custom attribute, Applivery automatically writes it into the user\u2019s <code>metadata<\/code>:\n<ul>\n<li><strong>Key<\/strong>: The name defined in the <code>mappedAttributes<\/code> entry.<\/li>\n<li><strong>Value<\/strong>: The resolved SCIM attribute value based on the mapping rules.<\/li><\/ul><\/li>\n<\/ol>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-e9a301e elementor-widget elementor-widget-heading\" data-id=\"e9a301e\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t\t<h3 class=\"elementor-heading-title elementor-size-default\">Example of a namespace-based mapping<\/h3>\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-186843e elementor-widget elementor-widget-heading\" data-id=\"186843e\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t\t<h4 class=\"elementor-heading-title elementor-size-default\">SCIM payload<\/h4>\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-5c54dea elementor-widget elementor-widget-code-highlight\" data-id=\"5c54dea\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"code-highlight.default\">\n\t\t\t\t\t\t\t<div class=\"prismjs-default copy-to-clipboard \">\n\t\t\t<pre data-line=\"\" class=\"highlight-height language-javascript line-numbers\">\n\t\t\t\t<code readonly=\"true\" class=\"language-javascript\">\n\t\t\t\t\t<xmp>{\n  \"schemas\": [\n    \"urn:ietf:params:scim:schemas:core:2.0:User\",\n    \"urn:company:params:scim:schemas:extension:custom:2.0:User\"\n  ],\n  \"urn:ietf:params:scim:schemas:core:2.0:User\": {\n    \"userName\": \"jane.smith\"\n  },\n  \"urn:company:params:scim:schemas:extension:custom:2.0:User\": {\n    \"employeeId\": \"EMP-4567\",\n    \"department\": \"Engineering\"\n  }\n}<\/xmp>\n\t\t\t\t<\/code>\n\t\t\t<\/pre>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-2e47ee3 elementor-widget elementor-widget-heading\" data-id=\"2e47ee3\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t\t<h4 class=\"elementor-heading-title elementor-size-default\">Custom mapping configuration<\/h4>\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-c97ac80 elementor-widget elementor-widget-code-highlight\" data-id=\"c97ac80\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"code-highlight.default\">\n\t\t\t\t\t\t\t<div class=\"prismjs-default copy-to-clipboard \">\n\t\t\t<pre data-line=\"\" class=\"highlight-height language-javascript line-numbers\">\n\t\t\t\t<code readonly=\"true\" class=\"language-javascript\">\n\t\t\t\t\t<xmp>const mappedAttributes = [\n  {\n    name: \"department\",\n    attributes: [\n      {\n        namespace: \"urn:company:params:scim:schemas:extension:custom:2.0:User\",\n        key: \"department\"\n      }\n    ]\n  },\n  {\n    name: \"employeeCode\",\n    attributes: [\n      {\n        namespace: \"urn:company:params:scim:schemas:extension:custom:2.0:User\",\n        key: \"employeeId\"\n      }\n    ]\n  }\n]<\/xmp>\n\t\t\t\t<\/code>\n\t\t\t<\/pre>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-cb9f5f9 elementor-widget elementor-widget-heading\" data-id=\"cb9f5f9\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t\t<h4 class=\"elementor-heading-title elementor-size-default\">Result in user's metadata<\/h4>\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-32528b9 elementor-widget elementor-widget-code-highlight\" data-id=\"32528b9\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"code-highlight.default\">\n\t\t\t\t\t\t\t<div class=\"prismjs-default copy-to-clipboard \">\n\t\t\t<pre data-line=\"\" class=\"highlight-height language-javascript line-numbers\">\n\t\t\t\t<code readonly=\"true\" class=\"language-javascript\">\n\t\t\t\t\t<xmp>{\n  \"metadata\": {\n    \"department\": \"Engineering\",\n    \"employeeCode\": \"EMP-4567\"\n  }\n}<\/xmp>\n\t\t\t\t<\/code>\n\t\t\t<\/pre>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-e98df00 elementor-widget elementor-widget-heading\" data-id=\"e98df00\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t\t<h2 class=\"elementor-heading-title elementor-size-default\">Configure attribute mapping on Applivery<\/h2>\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-5981d30 elementor-widget elementor-widget-text-editor\" data-id=\"5981d30\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t\t\t\t\t\t<p>Go to your\u00a0<strong>Workspace &gt; Settings<\/strong> <span style=\"color: #ff0000;\">(1) <\/span>and open the <strong>Login providers<\/strong> <span style=\"color: #ff0000;\">(2) <\/span>section. Then click <strong>Configure<\/strong> <span style=\"color: #ff0000;\">(3) <\/span>next to the <strong>SAML<\/strong> option under the <strong>MDM Portal<\/strong> section.<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-08cd97c elementor-widget elementor-widget-image\" data-id=\"08cd97c\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"image.default\">\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<img loading=\"lazy\" decoding=\"async\" width=\"800\" height=\"521\" src=\"https:\/\/www.applivery.com\/wp-content\/uploads\/2025\/11\/Screenshot-2025-11-25-at-162449-1024x667.png\" class=\"attachment-large size-large wp-image-72025\" alt=\"login-providers-settings\" srcset=\"https:\/\/www.applivery.com\/wp-content\/uploads\/2025\/11\/Screenshot-2025-11-25-at-162449-1024x667.png 1024w, https:\/\/www.applivery.com\/wp-content\/uploads\/2025\/11\/Screenshot-2025-11-25-at-162449-300x195.png 300w, https:\/\/www.applivery.com\/wp-content\/uploads\/2025\/11\/Screenshot-2025-11-25-at-162449-768x500.png 768w, https:\/\/www.applivery.com\/wp-content\/uploads\/2025\/11\/Screenshot-2025-11-25-at-162449-1536x1000.png 1536w, https:\/\/www.applivery.com\/wp-content\/uploads\/2025\/11\/Screenshot-2025-11-25-at-162449-2048x1333.png 2048w, https:\/\/www.applivery.com\/wp-content\/uploads\/2025\/11\/Screenshot-2025-11-25-at-162449-360x234.png 360w\" sizes=\"auto, (max-width: 800px) 100vw, 800px\" title=\"Screenshot 2025-11-25 at 162449 | Applivery\" \/>\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-8b80b21 elementor-widget elementor-widget-text-editor\" data-id=\"8b80b21\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t\t\t\t\t\t<p>Scroll down to <strong>Step 3<\/strong> and enter the appropriate namespace. You can determine the correct namespace based on the attribute type (Core, Enterprise, or Custom) and its value.<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-74c23eb elementor-widget elementor-widget-image\" data-id=\"74c23eb\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"image.default\">\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<img loading=\"lazy\" decoding=\"async\" width=\"800\" height=\"521\" src=\"https:\/\/www.applivery.com\/wp-content\/uploads\/2025\/11\/Screenshot-2025-11-25-at-163213-1024x667.png\" class=\"attachment-large size-large wp-image-72028\" alt=\"attribute-mapping\" srcset=\"https:\/\/www.applivery.com\/wp-content\/uploads\/2025\/11\/Screenshot-2025-11-25-at-163213-1024x667.png 1024w, https:\/\/www.applivery.com\/wp-content\/uploads\/2025\/11\/Screenshot-2025-11-25-at-163213-300x195.png 300w, https:\/\/www.applivery.com\/wp-content\/uploads\/2025\/11\/Screenshot-2025-11-25-at-163213-768x500.png 768w, https:\/\/www.applivery.com\/wp-content\/uploads\/2025\/11\/Screenshot-2025-11-25-at-163213-1536x1000.png 1536w, https:\/\/www.applivery.com\/wp-content\/uploads\/2025\/11\/Screenshot-2025-11-25-at-163213-2048x1333.png 2048w, https:\/\/www.applivery.com\/wp-content\/uploads\/2025\/11\/Screenshot-2025-11-25-at-163213-360x234.png 360w\" sizes=\"auto, (max-width: 800px) 100vw, 800px\" title=\"Screenshot 2025-11-25 at 163213 | Applivery\" \/>\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-d35b676 elementor-widget elementor-widget-text-editor\" data-id=\"d35b676\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t\t\t\t\t\t<p>To save your changes, simply click <span class=\"button-add\">Save<\/span>. Once your IdP performs its next scheduled sync, the mapped attributes on both sides will begin populating each user\u2019s <code>metadata<\/code> in Applivery.<\/p><p>To summarize:<\/p><ul><li>SCIM attributes can be mapped to user metadata using <code>mappedAttributes<\/code>.<\/li><li><code>namespace<\/code> helps disambiguate attributes when multiple schemas are involved.<\/li><li>Any unmapped SCIM attributes are stored in <code>attributesHistory<\/code> for future reference.<\/li><li>This mapping system gives you full control over how user data is stored and leveraged downstream.<\/li><\/ul>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t","protected":false},"excerpt":{"rendered":"<p>Learn how Applivery processes SCIM user attributes, tracks them internally, and maps selected fields into the metadata object using custom attribute configurations.<\/p>\n","protected":false},"author":5,"featured_media":32390,"parent":7964,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"content-type":"","inline_featured_image":false,"footnotes":""},"product":[],"doc_category":[149],"doc_tag":[],"class_list":["post-72010","docs","type-docs","status-publish","format-standard","has-post-thumbnail","hentry","doc_category-integrations"],"aioseo_notices":[],"year_month":"2026-04","word_count":552,"total_views":"487","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"name":"Karla Makowski","author_nicename":"karla-makowski","author_url":"https:\/\/www.applivery.com\/pt-br\/blog\/author\/karla-makowski\/"},"doc_category_info":[{"term_name":"Integrations","term_url":"https:\/\/www.applivery.com\/docs\/platform\/integrations\/"}],"doc_tag_info":[],"knowledge_base_info":[],"knowledge_base_slug":[],"_links":{"self":[{"href":"https:\/\/www.applivery.com\/pt-br\/wp-json\/wp\/v2\/docs\/72010","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.applivery.com\/pt-br\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/www.applivery.com\/pt-br\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/www.applivery.com\/pt-br\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/www.applivery.com\/pt-br\/wp-json\/wp\/v2\/comments?post=72010"}],"version-history":[{"count":9,"href":"https:\/\/www.applivery.com\/pt-br\/wp-json\/wp\/v2\/docs\/72010\/revisions"}],"predecessor-version":[{"id":72048,"href":"https:\/\/www.applivery.com\/pt-br\/wp-json\/wp\/v2\/docs\/72010\/revisions\/72048"}],"up":[{"embeddable":true,"href":"https:\/\/www.applivery.com\/pt-br\/wp-json\/wp\/v2\/docs\/7964"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.applivery.com\/pt-br\/wp-json\/wp\/v2\/media\/32390"}],"wp:attachment":[{"href":"https:\/\/www.applivery.com\/pt-br\/wp-json\/wp\/v2\/media?parent=72010"}],"wp:term":[{"taxonomy":"product","embeddable":true,"href":"https:\/\/www.applivery.com\/pt-br\/wp-json\/wp\/v2\/product?post=72010"},{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/www.applivery.com\/pt-br\/wp-json\/wp\/v2\/doc_category?post=72010"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.applivery.com\/pt-br\/wp-json\/wp\/v2\/doc_tag?post=72010"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}