@RequestMapping(value="/rest/session", method=PUT, produces="application/json")
| パラメータ | 説明 |
|---|---|
| user | ユーザ名 |
| pass | パスワード |
http://localhost:8921/wagby/rest/session
POSTと同様にContent-Typeをapplication/x-www-form-urlencodedとして送信します。
具体的には Content-Typeヘッダに "application/x-www-form-urlencoded" を指定し、次のような文字列を送信します。
user=admin&pass=admin
POSTMANを使う場合、図のようにx-www-form-urlencodedを指定し、パラメータを設定することで確認できます。
STATUS=200 OK
CookieにJSESSIONIDを返します。以降のREST API呼び出し時には、このJSESSIONIDを付与してください。
返戻の内容例を示します。
{
"groupId": [],
"username": "admin",
"passwdChangeDate": null,
"preference": {
"id": "admin",
"item": []
},
"status":"logon.afterLogon",
"juser": {
"id": 101,
"userid": "admin",
"jgroupid": [],
"name": "システム管理者",
"valid": null,
"level": 0,
"passwdChangeDate": null,
"passwdChangeFlag": null,
"passwdErrCount": null,
"lastLogonDate":1387281246638,
"rule": []
},
"passwdChangeFlag": null
}
STATUS=401 Unauthorized
返戻の内容例を示します。
{
"status":"logon.input",
"__jfc_jfcerrors": {
"jfcwarn": [],
"jfcinfo": [],
"jfcdebug": [],
"jfcerror": [
{
"name": null,
"content": "ユーザ名またはパスワードが間違っています。パスワードを連続して複数回間違えるとアカウントがロックされる場合があります。ご注意ください。",
"code": "error.password.mismatch"
}
]
}
}
REST API のログオン処理は、このハッシュ化パスワードにも対応してます。パスワードは平文のまま送ってください。
@RequestMapping(value="/rest/session", method=DELETE, produces="application/json")
http://localhost:8921/wagby/rest/session
STATUS=200 OK 返戻の内容例を示します。
{
"status":"logoff.input"
}
@RequestMapping(value="/rest/session", method=GET, produces="application/json")
http://localhost:8921/wagby/rest/session
上記「レスポンス ログオン成功時」と同じ。
STATUS=401 Unauthorized
内容は空です。
{}
一回の REST API 呼び出し時にログオンし、REST API 処理終了後にログオフする運用を行うことができます。この場合はセッションを維持する必要はありません。(上で説明したような、CookieにJSESSIONIDを保持することは不要です。)
REST API 呼び出し時に、リクエストヘッダに "X-Wagby-Authorization" をセットします。値は、ユーザーIDとパスワードをコロンで区切ったものを BASE64 で符号化したものを指定します。
例えば "admin:admin" を BASE64 で符号化すると "YWRtaW46YWRtaW4=" となります。
この方法はWagbyへHTTPリクエストを送るタイミングで、ヘッダにログオンIDとパスワードを付与しています。実際の運用では、HTTP暗号化通信 (HTTPS) を使うようにしてください。[詳細...]
次の点をご確認ください。