Add password policies
post
/iam/admin/access/api/v1/policy/PasswordPolicies
post method to add password policies to OAM.
Request
Query Parameters
-
tenantid(optional): string
tenant unique identifier
list of password policy assignments
Nested Schema : assignmentRule
Type:
Show Source
object
-
idStoreRef(optional):
string
The identity store reference id for which the current password policy is assigned to.
-
passwordPolicyID(optional):
string
This has to match with the password policy specified in the passwordPolicyInfo id
-
priority(optional):
integer
The priority for this password policy assignment. The policy for the user is ascertained by getting all the assignement rules for the idstore in which the user belongs, sorted using priority. The first applicable password policy is then chosen as the password policy applicable for the user.
-
ruleType(optional):
integer
The ruletype is an integer enumerator which specifies the kind of rule 1-none 2 -group
-
ruleValue(optional):
string
If the ruleType indicated group, then the rulevale indicates the group to which the user must belong to for the password policy to be applicable.
Nested Schema : passwordPolicyInfo
Type:
Show Source
object
-
allAtOnce(optional):
boolean
Not supported in OAM. A Boolean value. When true, the client UI will present all challengers in random order each time displayed. When false, the client UI will present one challenge question at a time where the subject MUST respond before the next is displayed.
-
challengePolicy(optional):
integer
Not supported in OAM. A complex attribute that defines policy around challenges. It contains the following sub-attributes.source An Integer indicating one of the following + 0 - User Defined. + 1 - Admin Defined. + 2 - User and Admin Defined.
-
challengesEnabled(optional):
boolean
Always false in OAM. A Boolean value indicating challenges MAY be used during authentication. Not supported. None of the challenge question/answers related policy elements are supported since OAM doesnt support user challenge questions/answers.
-
defaultQuestions(optional):
string
Not supported in OAM. A Multi-valued String attribute that contains one or more default question a subject may use when setting their challenge questions.Not supported in OAM
-
desc(optional):
string
A String that describes the current policy. Typically used for informational purposes (e.g. to display to a user).
-
dictionaryLocation(optional):
string
A Reference value containing the URI of a dictionary of words not allowed to appear within a password value.
-
disallowedChars(optional):
string
A String value whose contents indicates a set of characters that SHALL NOT appear, in any sequence, in a password value.
-
disallowedSubStrings(optional):
string
A Multi-valued String indicating a set of Strings that SHALL NOT appear within a password value.
-
expiresAfterDays(optional):
integer
An Integer indicating the numbers of days after which a password reset is required.
-
firstNameDisallowed(optional):
boolean
A Boolean indicating a sequence of characters matching the resource's "name.givenName" SHALL NOT be included in the password.
-
id(optional):
string
Unique identifier representing a specific password policy.
-
lastNameDisallowed(optional):
boolean
A Boolean indicating a sequence of characters matching the resource's "name.familyName" SHALL NOT be included in the password.
-
lockOutDuration(optional):
integer
An Integer indicating the number of minutes an account will be locked after maxIncorrectAttempts exceeded.
-
maxIncorrectAttempts(optional):
integer
An Integer representing the maximum number of failed logins before an account is locked.
-
maxIncorrectChallengesAttempts(optional):
integer
Not supported in OAM. An Integer indicates the maximum number of failed reset password attempts using challenges. If any challenges are wrong in a reset attempt, the users resetAttempts counter will be incremented by 1. If resetAttempts is greater than maxIncorrectAttempts, the subject's account will be locked with a locked.reason value.
-
maxLength(optional):
integer
An Integer indicating the maximum password length (in characters). A value of 0 or no value SHALL indicate no maximum length restriction.
-
maxRepeatedChars(optional):
integer
An Integer indicating the maximum number of repeated characters in a password. A value of 0 or no value SHALL indicate no restriction.
-
maxSpecialChars(optional):
integer
An Integer indicating the maximum number of special characters in a password. A value of 0 or no value SHALL indicate no maximum length restriction.
-
minAlphaNumerals(optional):
integer
An Integer indicating the minimum number of alphabetic or numeric characters in a password. A value of 0 or no value SHALL indicate no minimum length restriction.
-
minAlphas(optional):
integer
An Integer indicating the minimum number of alphabetic characters in a password. A value of 0 or no value SHALL indicate no minimum length restriction.
-
minAnswerCount(optional):
integer
Not supported in OAM. An Integer indicating the minimum number of challenge answers a subject MUST answer when attempting to reset their password via forgot password request.
-
minLength(optional):
integer
An Integer indicating the minimum password length (in characters). A value of 0 or no value SHALL indicate no minimum length restriction.
-
minLowerCase(optional):
integer
An Integer indicating the minimum number of lower-case alphabetic characters in a password. A value of 0 or no value SHALL indicateno minimum length restriction.
-
minNumerals(optional):
integer
An Integer indicating the minimum number of numeric characters in a password. A value of 0 or no value SHALL indicate no minimum length restriction.
-
minPasswordAgeInDays(optional):
integer
An Integer indicating the minimum age in days before the password can be changed.
-
minQuestionCount(optional):
integer
Not supported in OAM. An Integer indicating the minimum number of challenge questions a subject MUST answer when setting challenge question answers. A value of 0 or no value indicates no minimum. Not supported
-
minResponseLength(optional):
integer
Not supported in OAM. An Integer indicating the minimum number of characters in a challenge response. No value or a value of 0 indicates no minimum length (effectively 1).
-
minSpecialChars(optional):
integer
An Integer indicating the minimum number of special characters in a password. A value of 0 or no value SHALL indicate no minimum length restriction.
-
minUnicodeChars(optional):
integer
An integer indicating minimum number of unicode characters in a password.
-
minUniqueChars(optional):
integer
An Integer indicating the minimum number of unique characters in a password. A value of 0 or no value SHALL indicate no minimum restriction.
-
minUpperCase(optional):
integer
An Integer indicating the minimum number of upper-case alphabetic characters in a password. A value of 0 or no value SHALL indicate no minimum length restriction.
-
name(optional):
string
A String that is the name of the policy. Typically used for informational purposes (e.g. to display to the user)
-
passwordHistorySize(optional):
integer
An Integer indicating the number of passwords that will be kept in history that may not be used as a password.
-
requiredChars(optional):
string
A String value whose contents indicates a set of characters that MUST appear, in any sequence, in a password value.
-
startsWithAlpha(optional):
boolean
A Boolean indicating that the password MUST being with an alphabetic character.
-
userNameDisallowed(optional):
boolean
A Boolean indicating a sequence of characters matching the resource's "userName" SHALL NOT be included in the password.
-
warningAfterDays(optional):
integer
An Integer indicating the number of days after which a password reset warning will be issued.
Response
Supported Media Types
- application/json
200 Response
Password policy assignment
Nested Schema : assignmentRule
Type:
Show Source
object
-
idStoreRef(optional):
string
The identity store reference id for which the current password policy is assigned to.
-
passwordPolicyID(optional):
string
This has to match with the password policy specified in the passwordPolicyInfo id
-
priority(optional):
integer
The priority for this password policy assignment. The policy for the user is ascertained by getting all the assignement rules for the idstore in which the user belongs, sorted using priority. The first applicable password policy is then chosen as the password policy applicable for the user.
-
ruleType(optional):
integer
The ruletype is an integer enumerator which specifies the kind of rule 1-none 2 -group
-
ruleValue(optional):
string
If the ruleType indicated group, then the rulevale indicates the group to which the user must belong to for the password policy to be applicable.
Nested Schema : passwordPolicyInfo
Type:
Show Source
object
-
allAtOnce(optional):
boolean
Not supported in OAM. A Boolean value. When true, the client UI will present all challengers in random order each time displayed. When false, the client UI will present one challenge question at a time where the subject MUST respond before the next is displayed.
-
challengePolicy(optional):
integer
Not supported in OAM. A complex attribute that defines policy around challenges. It contains the following sub-attributes.source An Integer indicating one of the following + 0 - User Defined. + 1 - Admin Defined. + 2 - User and Admin Defined.
-
challengesEnabled(optional):
boolean
Always false in OAM. A Boolean value indicating challenges MAY be used during authentication. Not supported. None of the challenge question/answers related policy elements are supported since OAM doesnt support user challenge questions/answers.
-
defaultQuestions(optional):
string
Not supported in OAM. A Multi-valued String attribute that contains one or more default question a subject may use when setting their challenge questions.Not supported in OAM
-
desc(optional):
string
A String that describes the current policy. Typically used for informational purposes (e.g. to display to a user).
-
dictionaryLocation(optional):
string
A Reference value containing the URI of a dictionary of words not allowed to appear within a password value.
-
disallowedChars(optional):
string
A String value whose contents indicates a set of characters that SHALL NOT appear, in any sequence, in a password value.
-
disallowedSubStrings(optional):
string
A Multi-valued String indicating a set of Strings that SHALL NOT appear within a password value.
-
expiresAfterDays(optional):
integer
An Integer indicating the numbers of days after which a password reset is required.
-
firstNameDisallowed(optional):
boolean
A Boolean indicating a sequence of characters matching the resource's "name.givenName" SHALL NOT be included in the password.
-
id(optional):
string
Unique identifier representing a specific password policy.
-
lastNameDisallowed(optional):
boolean
A Boolean indicating a sequence of characters matching the resource's "name.familyName" SHALL NOT be included in the password.
-
lockOutDuration(optional):
integer
An Integer indicating the number of minutes an account will be locked after maxIncorrectAttempts exceeded.
-
maxIncorrectAttempts(optional):
integer
An Integer representing the maximum number of failed logins before an account is locked.
-
maxIncorrectChallengesAttempts(optional):
integer
Not supported in OAM. An Integer indicates the maximum number of failed reset password attempts using challenges. If any challenges are wrong in a reset attempt, the users resetAttempts counter will be incremented by 1. If resetAttempts is greater than maxIncorrectAttempts, the subject's account will be locked with a locked.reason value.
-
maxLength(optional):
integer
An Integer indicating the maximum password length (in characters). A value of 0 or no value SHALL indicate no maximum length restriction.
-
maxRepeatedChars(optional):
integer
An Integer indicating the maximum number of repeated characters in a password. A value of 0 or no value SHALL indicate no restriction.
-
maxSpecialChars(optional):
integer
An Integer indicating the maximum number of special characters in a password. A value of 0 or no value SHALL indicate no maximum length restriction.
-
minAlphaNumerals(optional):
integer
An Integer indicating the minimum number of alphabetic or numeric characters in a password. A value of 0 or no value SHALL indicate no minimum length restriction.
-
minAlphas(optional):
integer
An Integer indicating the minimum number of alphabetic characters in a password. A value of 0 or no value SHALL indicate no minimum length restriction.
-
minAnswerCount(optional):
integer
Not supported in OAM. An Integer indicating the minimum number of challenge answers a subject MUST answer when attempting to reset their password via forgot password request.
-
minLength(optional):
integer
An Integer indicating the minimum password length (in characters). A value of 0 or no value SHALL indicate no minimum length restriction.
-
minLowerCase(optional):
integer
An Integer indicating the minimum number of lower-case alphabetic characters in a password. A value of 0 or no value SHALL indicateno minimum length restriction.
-
minNumerals(optional):
integer
An Integer indicating the minimum number of numeric characters in a password. A value of 0 or no value SHALL indicate no minimum length restriction.
-
minPasswordAgeInDays(optional):
integer
An Integer indicating the minimum age in days before the password can be changed.
-
minQuestionCount(optional):
integer
Not supported in OAM. An Integer indicating the minimum number of challenge questions a subject MUST answer when setting challenge question answers. A value of 0 or no value indicates no minimum. Not supported
-
minResponseLength(optional):
integer
Not supported in OAM. An Integer indicating the minimum number of characters in a challenge response. No value or a value of 0 indicates no minimum length (effectively 1).
-
minSpecialChars(optional):
integer
An Integer indicating the minimum number of special characters in a password. A value of 0 or no value SHALL indicate no minimum length restriction.
-
minUnicodeChars(optional):
integer
An integer indicating minimum number of unicode characters in a password.
-
minUniqueChars(optional):
integer
An Integer indicating the minimum number of unique characters in a password. A value of 0 or no value SHALL indicate no minimum restriction.
-
minUpperCase(optional):
integer
An Integer indicating the minimum number of upper-case alphabetic characters in a password. A value of 0 or no value SHALL indicate no minimum length restriction.
-
name(optional):
string
A String that is the name of the policy. Typically used for informational purposes (e.g. to display to the user)
-
passwordHistorySize(optional):
integer
An Integer indicating the number of passwords that will be kept in history that may not be used as a password.
-
requiredChars(optional):
string
A String value whose contents indicates a set of characters that MUST appear, in any sequence, in a password value.
-
startsWithAlpha(optional):
boolean
A Boolean indicating that the password MUST being with an alphabetic character.
-
userNameDisallowed(optional):
boolean
A Boolean indicating a sequence of characters matching the resource's "userName" SHALL NOT be included in the password.
-
warningAfterDays(optional):
integer
An Integer indicating the number of days after which a password reset warning will be issued.
401 Response
Unauthorized
404 Response
Requested entity not found
500 Response
Internal Server Error