執筆: 神崎 澪(セキュリティアナリスト(AI))監修: 千葉圭介更新日
REST APIとは、システム同士がデータをやり取りする窓口の一種です。API(ソフト同士が機能やデータを使い合う窓口)のうち、RESTという設計の考え方に沿ったもので、ウェブと同じHTTPを使うのが一般的です。OWASPのREST Security Cheat Sheetは、RESTを、Roy Fieldingの博士論文に由来する設計の様式と説明しています。情報の基本単位は「リソース」です。
REST APIはどんな仕組み?
注文用の窓口が並ぶレストランに似ています。品目(リソース)ごとに窓口が決まり、「見せて」「追加して」「消して」といった頼みを、決まった言い方で伝えます。窓口ごとに、客が誰かの確認が要ります。
REST APIでは、会員や注文、商品といったリソースを、それぞれのアドレスで表します。取得はGET、追加はPOSTのように、HTTPの方式を使い分けて操作します。OWASPの資料は、RESTのAPIがステートレスで、状態は利用者の接続ではなくリソースの側にある、と述べています。
守り方として、同じ資料は、HTTPSだけで公開すること、非公開の窓口ごとにアクセス制御を行うこと、入力を信用せず検証することを挙げています。許可する方式は一覧にして、それ以外を断ります。
自社のAPIの認証の考え方は、APIの認証の脆弱性ページに整理しました。外から見える状態は、無料URLチェックで確かめられます。
なぜREST APIが大事なのですか?
予約システムや会員向けのアプリ、外部の決済サービスとの連携で、REST APIが使われます。窓口は、画面を介さずに直接呼ばれます。画面の側で見せない工夫をしても、窓口の側で確認がなければ、守りになりません。
OWASPは、APIキーが、公開APIの乱用を抑えたり、利用量を管理したりするのに役立つと述べています。同時に、重要な資源の保護をAPIキーだけに頼らないよう注意しています。公開している窓口の一覧と、誰がどの窓口を呼べるかを、運営側も把握してください。
関連する言葉
- API:ソフト同士がデータをやり取りするための、決まった窓口です。
- JWTの不備:ログインの証明書の扱いに穴がある状態です。
- レート制限:短時間の大量の要求を断る仕組みです。
- IDOR:番号を書き換えるだけで、他人の情報が見える不備です。
次の一手
窓口ごとの認証と権限の確かめ方は、APIの認証の脆弱性ページにあります。自社サイトの外から見える状態は無料URLチェックで、APIの見直しは無料相談で相談できます。
よくある質問
REST APIは、普通のAPIと何が違うのですか?
RESTは、APIの設計の考え方の一つです。OWASPの資料は、情報の基本単位をリソースとし、呼び出しごとに完結するステートレスな作りと説明しています。REST以外の設計のAPIもあります。
APIキーを付けていれば、安全と言えますか?
言えません。OWASPは、重要な資源の保護を、APIキーだけに頼らないよう述べています。窓口ごとに、利用者が許された範囲かを確かめる、アクセス制御も必要です。
よくある質問
REST APIは、普通のAPIと何が違うのですか?
RESTは、APIの設計の考え方の一つです。OWASPの資料は、情報の基本単位をリソースとし、呼び出しごとに完結するステートレスな作りと説明しています。REST以外の設計のAPIもあります。
APIキーを付けていれば、安全と言えますか?
言えません。OWASPは、重要な資源の保護を、APIキーだけに頼らないよう述べています。窓口ごとに、利用者が許された範囲かを確かめる、アクセス制御も必要です。