OutSystems 11にはあった、サーバサイドでUsernameとPasswordを指定して（あるいはUserIdだけを指定して）ログインさせるActionが、ODCでは無くなった。
そのため、認証をかけたExpose REST APIで、各Methodで認証を通ったユーザー名などの情報を取ろうと思うと、リクエストヘッダからBasic認証情報を再取得する必要がある。この手順を確認しておく。
環境情報
ODC Studio(Version 1.4.21)
Basic認証付きExpose REST APIの作り方
作成したREST APIのプロパティから、Security > AuthenticationでBasicを選択。
自動的にOnAuthentication Callbackが作成され、Basic認証情報がそのInput Parameterとして渡される。
ODCでBasic認証する場合の問題点
サーバーサイドでUsernameとPassword (Users/User_Login Action) 、あるいはUserId ((System)/Login Action) を指定してログインさせるActionが、OutSystems 11にはあった。
しかし、ODCにはそういうActionが無い。
⇨ OnAuthenticationで、受け取ったUsernameとPasswordをEntityやSettingの値に対して検証することはできるが、「ODCにログインさせる」ことはできない
⇨ 後続のREST API Methodで「ログイン中のユーザーの情報を取り出す」ことができない
という問題がある。
この問題の解決策として、REST API Methodでも、Basic認証の認証情報を取り出す方法を確認しておく。
Basic認証情報のフォーマット
入力したBasic認証情報は、Authorizationというリクエストヘッダーに、「Basic Base64エンコードしたUsername:Password」という形式で入る。
以下は、Basic認証をかけたExpose REST APIにリクエストし、Username=testuser、Password=testpasswordを入力した場合のヘッダの例。
REST API Method中で、Basic認証情報を取り出す方法
リクエストヘッダに平文で入っているわけなので、標準APIの組み合わせで取得可能。
処理の流れは以下の通り。
- リクエストヘッダを取るにはHTTP/Request_GetHeader Actionを使う。NameパラメータにはAuthorizationを指定
- 取得したヘッダ値先頭にある「Basic 」（スペースがついていることに注意）を、Built-in FunctionのSubstrを使って切り捨て、Base64エンコードした部分を切り出す
- BinaryData/Base64ToBinary ActionでBase64エンコードした文字列をBinary Data型に変換（直接Text型にするActionが標準にはないので）
- BinaryData/BinaryDataToText ActionでBinary DataをText型に戻す
上記の流れを実装した例。コメントに各ステップでプロパティに設定する値を示している。BinaryDataToTextのOutput Parameterに「Username:Password」形式の文字列が入っている。
