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 (空)