{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"d24eb688-1bba-4d67-8031-e2c2f91fa459"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"ee504cf5-24f7-47b7-affe-ad1804476fa1"}},{"type":"rule"},{"type":"paragraph","content":[{"text":"User field synchronization can be configured in the dashboard for a database under \"Settings\" → \"User Auth & Sync Settings\".","type":"text"}]},{"type":"paragraph","content":[{"text":"Example configuration","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n \n \n ([a-z0-9])*\n [...]\n\n \n \t\n \n \n \n \n\n \n","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Attributes","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"batchSize","type":"text","marks":[{"type":"strong"}]},{"text":" The ","type":"text"},{"text":"UserSyncJob","type":"text","marks":[{"type":"code"}]},{"text":" synchronizes users in batches. This attribute can be used to adjust the number of users in a batch. The value must be between 1 and 100. – Default: 10","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"syncIntervalInSeconds","type":"text","marks":[{"type":"strong"}]},{"text":" Sets the interval in seconds for synchronization. The value must be greater than 60. Default: 86400 (= 1 day)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"syncTimeoutInSeconds","type":"text","marks":[{"type":"strong"}]},{"text":" When synchronization is started, a time stamp is stored with the user. If an error occurs during synchronization or the action is aborted, the user remains in this state. This attribute can be used to set a \"timeout\" in seconds so that the user is again captured by the synchronization process. The value must be between 10 and 3600. Default: 60","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"skipLockedFields","type":"text","marks":[{"type":"strong"}]},{"text":" In the default case, all fields are synchronized – depending on the configuration. If locked user fields should be excluded from synchronization, this value can be set to ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":". Default: false","type":"text"}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"SyncSources","type":"text"}]},{"type":"paragraph","content":[{"text":"The following sources are currently available for synchronization:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"LdapSyncSource","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/PDT/pages/32571582"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Microsoft Graph","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/PDT/pages/32735469"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"HttpSyncSource","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/PDT/pages/32669955"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"StaticSyncSource","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/PDT/pages/32571609"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CsvSyncSource","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/PDT/pages/33292344"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SqlSyncSource","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/PDT/pages/63635457"}}]}]}]}]},{"type":"paragraph","content":[{"text":"All SyncSources have the following attributes and elements in common:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"name","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"queryKey","type":"text","marks":[{"type":"strong"}]},{"text":" Field name to be used as a parameter for the query. Available are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"OneOffixxIdentifier","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"User.SID","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"User.Title","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"isOptional","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"QueryKeyRegex","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"(optional)","type":"text","marks":[{"type":"em"}]},{"text":" If only part of the value of the QueryKey is to be used, it can be specified here.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Claims","type":"text","marks":[{"type":"strong"}]},{"text":" see next section","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"NOTE when using \"User.Title\"","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"The ","type":"text"},{"text":"User.Title","type":"text","marks":[{"type":"code"}]},{"text":" is the name of the user in the OneOffixx database. The source of the name can be determined via the properties of the \"Active Directory Connector\" or the \"Office 365 Connector\". An adjustment is possible at any time and is applied during user synchronization.","type":"text"}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Claims","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"type","type":"text","marks":[{"type":"strong"}]},{"text":" describes the claim path. It must have a valid URI format, but does not have to exist – as long as it is only used in OneOffixx. If it is not used only in OneOffixx, it is beneficial to follow ","type":"text"},{"text":"Microsoft's claims","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.microsoft.com/en-us/previous-versions/windows-identity-foundation/ee727097(v=msdn.10)"}}]},{"text":".","type":"text"}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"property","type":"text","marks":[{"type":"strong"}]},{"text":" is the counterpart to the property defined in the SyncSource. The values of the two must be identical.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"In addition to direct assignments, claims can also store certain rules:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"useValueIfEmpty","type":"text","marks":[{"type":"strong"}]},{"text":" If set to ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":": if the property in the SyncSource is empty, the default value inside the ","type":"text"},{"text":"Claim","type":"text","marks":[{"type":"code"}]},{"text":" element is taken. If there is no value, the field remains empty.","type":"text"}]}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"Fallback-Value","type":"text"}]},{"type":"paragraph","content":[{"text":"If you define a claim for the user synchronization and map it to a field at the end, the corresponding value is applied. However, if you want to avoid, for example, that empty properties are applied from the SyncSource, you can also \"ignore\" the claim via the following property:","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"HINWEIS","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"The ","type":"text"},{"text":"LdapSyncSource","type":"text","marks":[{"type":"code"}]},{"text":" maps only \"existing\" attributes by itself, other sources handle this differently.","type":"text"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ignoreClaimIfEmpty","type":"text","marks":[{"type":"strong"}]},{"text":" If set to ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":", empty fields in the SyncSource will be ignored. Otherwise, depending on the SyncSources, empty fields are also synchronized to the user and user-defined values are overwritten.","type":"text"}]}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"","type":"text"}]},{"type":"paragraph","content":[{"text":"Claims also support regex so that, for example, parts of values can be accessed.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n ([a-z\\\\.]*)@([a-z\\\\.]*) \n","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"match","type":"text","marks":[{"type":"strong"}]},{"text":" Index of the match, mostly 0","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"group","type":"text","marks":[{"type":"strong"}]},{"text":" Index of the group","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Attention!","type":"text","marks":[{"type":"strong"}]},{"text":" The group number can be increased by 1, because in group 0 may be the fullmatch.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"value","type":"text","marks":[{"type":"strong"}]},{"text":" Valid regex expression","type":"text"}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Multilingualism","type":"text"}]},{"type":"paragraph","content":[{"text":"By default, user synchronization only synchronizes fields in the default document language. If you want to set certain field contents also in other languages, for example, this is possible by setting the ","type":"text"},{"text":"lcid","type":"text","marks":[{"type":"strong"}]},{"text":" attribute:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n","type":"text"}]},{"type":"paragraph","content":[{"text":"In this example, the claim ","type":"text"},{"text":"http://schemas.xmlsoap.org/ws/2005/05/identity/claims/function","type":"text","marks":[{"type":"code"}]},{"text":" is filled in the default document language via the ","type":"text"},{"text":"description","type":"text","marks":[{"type":"code"}]},{"text":" property. In the example, the same claim is assigned to the respective property from the source for the document language Italian and French (LCID 1040 and 1036). The rules of the normal claims also apply to these \"translated\" claims.","type":"text"}]}],"version":1}

Browser not supported