SOAP API 開発者ガイド
jsetPassword()
構文
使用方法
User またはSelfServiceUser のパスワードを指定の値に変更するには、setPassword() を使用します。たとえば、クライアントアプリケーションは、ユーザに異なるパスワードを指定するように促し、次にシステム管理者によるユーザのパスワード変更のためにsetPassword() を呼び出す可能性があります。API によって生成されたランダム値にパスワードをリセットする場合は、代わりに、resetPassword() を使用してください。
このコールは、組織のパスワードポリシー設定 [セルフリセットに setPassword() API を使用することを許可] が有効である場合に限り、ユーザに自分のパスワード変更を許可するために使用できます。それ以外の場合は、changeOwnPassword() を使用します。変更を許可する前にユーザーの現在のパスワードを確認するため、こちらの方が安全です。
クライアントアプリケーションは、そのユーザのパスワードを変更するために必要なアクセス権限でログインされている必要があります。詳細は、「データアクセスに影響する要素」を参照してください。
ID についての詳細は、「ID データ型」を参照してください。
パスワードが失効していた場合、このコールは、LoginResult 内で返されるセッション ID を使用可能です。詳細は、「passwordExpired」 を参照してください。
サンプルコード —Java
このサンプルでは、ユーザ ID およびパスワードパラメータを受け取り、これらを使用して指定されたユーザのパスワードを設定する setPassword() コールを実行します。
サンプルコード —C#
このサンプルでは、ユーザ ID およびパスワードパラメータを受け取り、これらを使用して指定されたユーザのパスワードを設定する setPassword() コールを実行します。
引数
| 名前 | 型 | 説明 |
|---|---|---|
| userID | ID | パスワードをリセットする User または SelfServiceUser の ID。ID についての詳細は、「ID データ型」を参照してください。 |
| password | string | 指定されたユーザのために使用される新しいパスワード。 |
応答
SetPasswordResult (空)