REST APIとは

REST APIとは、システム同士がデータをやり取りする窓口の一種です。OWASPの資料をもとに、リソースとHTTPの使い方、窓口ごとに行う権限の確認、APIキーだけに頼らない理由を、中小企業の運営者向けにやさしく説明します。

執筆: 神崎 澪(セキュリティアナリスト(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キーだけに頼らないよう述べています。窓口ごとに、利用者が許された範囲かを確かめる、アクセス制御も必要です。

外から見える穴を、今日のうちに確かめませんか

無料のURLチェックは数十秒で結果が出ます。費用の見当や進め方は、無料相談でご説明します。