Sun Identity Manager 8.1 Web Services

Password Capabilities

Identity Manager supports the Password capabilities described in the following table.

Table 2–6 Password Capabilities

Capability 

Description 

Caveats 

ExpirePasswordRequest

Expires a password. 

  • You cannot specify resources or targets. Doing so causes the Identity Manager User object password to expire; which then causes the password on all of the user’s resources to expire.

  • Identity Manager does not support the remainingLogins attribute. If you set this attribute to anything other than the default (1 or less), an OperationNotSupported error occurs.

ResetPasswordRequest

Resets a password and returns the new value on all accounts. 

Passwords are sensitive. Use SSL or some other secure transport. 

SetPasswordRequest

Sets a password. 

Passwords are sensitive. Use SSL or some other secure transport. 

ValidatePasswordRequest

Determines whether a given password is valid. 

Passwords are sensitive. Use SSL or some other secure transport. 

Example Password capabilities follow.

ResetPasswordRequest Example

The following example illustrates a typical ResetPasswordRequest.


Example 2–13 Example ResetPasswordRequest

ResetPasswordRequest rpr = new ResetPasswordRequest();
...
PSOIdentifier psoId = new PSOIdentifier(accountId, null, null);
 rpr.setPsoID(psoId);
...

SetPasswordRequest Example

The following example illustrates a typical SetPasswordRequest.


Example 2–14 Example SetPasswordRequest

SetPasswordRequest spr = new SetPasswordRequest();
...
PSOIdentifier psoId = new PSOIdentifier(accountId, null, null);
spr.setPsoID(psoId);
spr.setPassword("newpassword");
spr.setCurrentPassword("oldpassword");
...

ValidatePasswordRequest Example

The following example illustrates a typical ValidatePasswordRequest.


Example 2–15 Example ValidatePasswordRequest

ValidatePasswordRequest vpr = new ValidatePasswordRequest();
...
PSOIdentifier psoId = new PSOIdentifier(accountId, null, null);
vpr.setPsoID(psoId);
vpr.setPassword("apassword");
...