メインコンテンツまでスキップ

Kurocoのセキュリティ設定の見直し

Kurocoで構築したサイトを公開する前や、運用中の定期的な点検で見直すべきセキュリティ設定をまとめて説明します。
この記事では、被害が大きい次の3つを防ぐための設定に絞って説明します。それ以外の設定は、セキュリティアドバイザリーで確認してください。

  • 個人情報の流出
  • 管理画面の乗っ取り
  • 攻撃による意図しない費用の増加

各項目では、設定しない場合に想定される危険と、その設定で何を防ぐのかをあわせて説明します。サイトの用途に応じて、どこまで制限するかを判断する材料にしてください。

各設定の確認と変更には、対象の設定画面の権限が必要です。

個人情報の流出につながる設定​

個人情報の流出は、1つの設定漏れではなく、複数の設定漏れが重なって起こります。特に次の組み合わせに注意してください。

  • 誰でも会員登録・ログインできる状態で、会員登録時に付与されるグループに、他の会員の情報を返すエンドポイントへのアクセスを許可している
  • [APIリクエスト制限]のないエンドポイントで、メンバー情報やフォームの回答などの個人情報を返している
  • filter_request_allow_listに:ALLを設定し、レスポンスに含まれない項目でも絞り込みができる

エンドポイントのURLを知られないことや、ログインを必須にしていることだけでは、制限になりません。以降の各項目で、それぞれの設定が何を防ぐのかを説明します。

現在の設定を確認する​

セキュリティアドバイザリーで確認する​

管理画面のヘッダーにある[セキュリティ]をクリックすると、セキュリティアドバイザリー画面が表示されます。[セキュリティ]のリンクとセキュリティアドバイザリー画面は、「セキュリティアドバイザリー」の[閲覧]権限を持つグループにのみ表示されます。
[セキュリティアドバイザリー]タブでは、サイトの設定のうちセキュリティ上の確認が必要なものが指摘として一覧で表示されます。[セキュリティインベントリ]タブでは、アクセス制限と認証に関わる設定の現在値を、[共通][管理画面][公開API]に分けて確認できます。設定名をクリックすると、その設定を変更できる画面に移動します。

以降の項目を見直す前に、この画面で指摘と現在の設定を確認してください。指摘された設定を変更するかどうかは、以降の各項目で説明する危険と、サイトの用途をもとに判断します。

AIエージェントで点検する​

Admin MCPとKuroco Skillsのkuroco-security-auditを利用すると、APIのセキュリティ方式・CORS・IPアドレス制限、権限グループ、静的アクセストークンなどの設定を、AIエージェントで点検してレポートを作成できます。kuroco-security-auditは読み取り専用で、設定は変更しません。

APIの設定を見直す​

APIのセキュリティ方式を確認する​

静的アクセストークンは、フロントエンドのJavaScriptに含めると、ブラウザの開発者ツールなどで誰でも確認できます。トークンを入手した第三者は、正規のフロントエンドと同じようにAPIへリクエストできます。そのため、静的アクセストークンは「トークンを付与していない無差別なアクセスを拒否する」ための設定であり、データを保護する手段にはなりません。

  • トークンは秘匿情報にはならないため、定期的に更新する前提で運用してください。
  • 会員だけに見せる情報など、アクセスを制限したいデータを扱う場合は、動的アクセストークン・Cookieによるログイン認証や、閲覧グループによる制限を利用してください。

また、どの認証方式でも、エンドポイントで取得・更新できるデータの範囲はエンドポイントの設定で決まります。エンドポイントの設定はエンドポイントの設定を見直すで確認します。

CORSを設定する​

CORSは、どのオリジン(サイト)のブラウザ上のJavaScriptから、APIのレスポンスを読み取れるかを決める設定です。許可するオリジンが広すぎると、第三者のサイトに埋め込まれたJavaScriptから、そのサイトを訪れた利用者のブラウザ経由でAPIを呼び出されます。

特にCORS_ALLOW_CREDENTIALSを有効にしている場合にCORS_ALLOW_ORIGINSにワイルドカード(*)を指定すると、すべてのオリジンがCookieを伴うリクエストの送信とレスポンスの読み取りを許可されます。攻撃者のサイトを会員が訪れただけで、その会員のセッションでAPIを実行され、会員情報を読み取られたり更新されたりする可能性があります。

  • CORS_ALLOW_ORIGINSには、APIを利用するフロントエンドのオリジンのみを明示的に設定します。
  • テスト用のURLが残っている場合は、サイト公開後に削除します。
  • サブドメインのワイルドカード(https://*.example.com)を指定している場合は、対象となるサブドメインすべてが管理下にあることを確認します。
注記

CORSはブラウザが適用する制限です。ブラウザ以外のプログラムから直接送られるリクエストは、CORSでは防げません。APIへのアクセスそのものを制限するには、APIのセキュリティ方式やIPアドレス制限、エンドポイントの[APIリクエスト制限]をあわせて設定します。

IPアドレス制限・国制限を設定する​

APIのURLやトークンが外部に知られた場合でも、IPアドレス制限を設定していれば、許可していないアクセス元からのリクエストは拒否されます。社内システムやサーバー間連携など、APIのアクセス元が決まっている場合は、APIの[セキュリティ]の[IPアドレス制限]を設定します。

一般の利用者に公開するAPIでアクセス元を特定できない場合は、[国制限]で想定していない国からのアクセスを拒否できます。[IPアドレス制限]と[国制限]の両方を指定した場合は、どちらかに当てはまるアクセスを許可します。国の判定は必ずしも正確ではなく、海外出張中の利用者やVPN経由のアクセスも拒否の対象になるため、APIログの[国コード]でアクセス元を確認してから設定してください。

同一IPからの流量制限を設定する​

1つのアクセス元から大量のリクエストを送られると、APIリクエストの課金が増えるほか、エンドポイントの[流量制限]の上限をその1つのアクセス元に使い切られ、正規の利用者のリクエストまで拒否されます(流量制限を設定する)。

APIの[セキュリティ]の[同一IPからの流量制限]を設定すると、同じIPアドレスからAPI内の全エンドポイントへのリクエストの合計を制限できます。社内ネットワークやモバイル回線では複数の利用者が同じIPアドレスを共有している場合があるため、上限は想定される利用状況に余裕を持たせて設定してください。

エンドポイントの設定を見直す​

不要なエンドポイントを無効にする​

利用していないエンドポイントも、有効なままであればリクエストを受け付けます。開発中に作成したテスト用のエンドポイントなどは、[APIリクエスト制限]や出力許可リストが設定されていないまま残っていることがあり、URLを知られるとデータの取得や更新に使われる可能性があります。

利用していないエンドポイントは、エンドポイントの編集画面の[ステータス]で無効にするか、削除します。
エンドポイントの[サマリー]に利用用途を記載しておくと、不要なエンドポイントを判断しやすくなります。
直近30日間に成功したリクエストがない公開中のエンドポイントは、セキュリティアドバイザリー画面の[セキュリティインベントリ]タブの[不要API]で確認できます。[不要API]は「API」の[閲覧]権限を持っている場合に表示されます。

会員のみに使わせるエンドポイントにAPIリクエスト制限を設定する​

[APIリクエスト制限]がNoneのエンドポイントは、ログインしていない利用者もリクエストできます。エンドポイントのURLはフロントエンドのJavaScriptや通信内容から確認できるため、「画面にリンクを置いていない」ことは制限になりません。

ログインした会員のみに使わせるエンドポイントは、[APIリクエスト制限]にGroupAuthまたはMemberCustomSearchAuthを設定し、リクエストした会員の権限を確認するようにします。

注意

たとえばMember::list・Member::details(メンバー情報)やInquiryMessage::list(フォームの回答)をNoneのまま公開すると、URLが流出したり総当たりで特定されたりした時点で、誰でも個人情報を取得できます。
用途に応じて[APIリクエスト制限]を設定する、出力許可リストで公開する項目のみに絞る、などの対応をしてください。

filterで指定できる項目を制限する​

filter_request_allow_listは、フロントエンドからのfilterリクエストで指定できる項目を設定するパラメータです。
:ALLを設定すると全項目で絞り込みができるようになります。出力許可リストでレスポンスから除外した項目でも、比較演算子で値を変えながら絞り込み、結果が返るかどうかを確かめることで、値を推測される可能性があります。

:ALLは設定せず、フロントエンドの検索・絞り込みで実際に使う項目のみを指定します。

出力許可リストを設定する​

エンドポイントのレスポンスには、デフォルトで全項目が含まれます。フロントエンドの画面に表示していない項目も、ブラウザの開発者ツールなどでレスポンスを見れば確認できます。たとえば、管理用のメモや非公開を想定した拡張項目、メンバーの連絡先などが、意図せず公開されている状態になります。

エンドポイントの後処理で出力許可リストを設定し、フロントエンドで必要な項目のみをレスポンスします。コンテンツ詳細やメンバー情報を返すエンドポイントでは、特に公開を想定していない項目が含まれていないかを確認してください。

メンバー情報のエンドポイントでself_onlyを有効にする​

マイページなど、ログインしているメンバーが自分の情報を表示・更新するためのエンドポイントでself_onlyを有効にしない場合、エンドポイントのURLが分かれば任意のメンバー情報を取得できます。更新のエンドポイントであれば、他のメンバーの情報を書き換えられる可能性もあります。

self_onlyを有効にすると、ログインしているメンバー自身の情報のみにアクセスできるよう制限されます。

AIのエンドポイントの入出力を制限する​

AIのエンドポイントを公開すると、サイトの用途とは関係のない質問や、長い入力テキストを大量に送られる可能性があります。サイトの用途と関係のない利用が増えると、AIの処理量が増え、本来の利用者への応答にも影響します。

AIモデルのchatなどのエンドポイントでは、以下のパラメータの設定をおすすめします。

パラメータ推奨する設定設定の意図
prompt回答する情報や分野を限定する指示を記載します。サイトの用途と関係のない利用を抑えます。
max_tokens_out出力の最大トークン数を少なめに設定します。1回のリクエストで生成される量を抑えます。
max_input_length入力テキストの最大文字数を設定します。長い入力テキストによる処理量の増加を抑えます。
safe_check有効にして、入力テキストの安全性チェックを行います。不適切な入力テキストへの応答を抑えます。

あわせて、APIリクエスト制限や流量制限で、利用できる人とリクエスト数を制限することも検討してください。

流量制限を設定する​

フォームの送信やログインなど、外部に公開しているエンドポイントは、ボットによる大量送信やログインの試行の対象になります。大量のリクエストを受けると、APIリクエストの課金が増えるほか、フォームの送信内容がスパムで埋まるなどの被害が出ます。

エンドポイントの編集画面の[流量制限]を設定すると、指定した秒数の間に受け付けるリクエスト数を制限できます。
ただし、[流量制限]は送信元IPアドレスやアクセストークンごとではなく、エンドポイントに対する全リクエストの合計で数えます。上限に達すると正規の利用者のリクエストも拒否されるため、特定のIPアドレスからの大量のリクエストを制限したい場合は、APIの[同一IPからの流量制限]を併用します(同一IPからの流量制限を設定する)。

管理画面とユーザーの設定を見直す​

管理画面・KurocoFiles・Admin MCPのアクセス制限を設定する​

管理画面とAdmin MCPからは、サイトの設定やコンテンツ、メンバー情報を操作できます。アクセス元を制限していない場合、パスワードやAdmin MCPのトークンが漏えいすると、どこからでもログインや操作をされる可能性があります。

社内ネットワークなど、アクセス元が決まっている場合は、[環境設定] -> [管理画面]で以下のIPアドレス制限を設定します。

対象設定項目
管理画面[管理画面のアクセス制限(IPアドレス)]
KurocoFiles[KurocoFilesのアクセス制限(IPアドレス)]
Admin MCP[Admin MCPのアクセス制限(IPアドレス)]

[有効にする]にチェックを入れたうえで[国制限]で国を選択すると、選択した国からのアクセスも許可します。IPアドレスと国のどちらかに一致すれば許可し、国を判定できないアクセスはIPアドレスで許可されない限り拒否します。提供版: β / RC版

管理画面ログインに2要素認証を必須にする​

パスワードだけでログインできる場合、他のサービスから流出したパスワードの使い回しや、フィッシングなどでパスワードを知られると、第三者に管理画面へログインされます。2要素認証を必須にすると、パスワードを知られただけではログインできなくなります。

[環境設定] -> [サイト管理]の[ワンタイムパスワード]または[パスキー]を[必須]にすると、管理画面へのログインに2要素認証が必要になります。2要素認証を登録していない既存ユーザーは、登録するまで管理画面にログインできなくなり、ログイン時に登録画面が表示されます。

2要素認証を設定していないユーザーは、セキュリティアドバイザリー画面の[セキュリティインベントリ]タブの[2要素認証を設定していないユーザー]で確認できます。「サイト管理」と「メンバー」の[閲覧]権限を持ち、閲覧できるメンバーがグループで制限されていない場合に表示されます。

長期間ログインしていないユーザーのログインを停止する​

退職者や契約が終了した外部の協力会社のユーザーなど、利用しなくなったユーザーがログインできる状態のまま残っていると、そのパスワードが漏えいした場合に不正にログインされます。本人が利用していないため、不正なログインに気づきにくくなります。

直近90日間にログインしていない、ログイン可能な編集ユーザーとスーパーユーザーは、セキュリティアドバイザリー画面の[セキュリティインベントリ]タブの[長期未ログイン]で確認できます。「ログ管理」の[閲覧]権限を持っている場合に表示されます。作成から90日未満のユーザーは含まれません。また、代理ログインとAdmin MCPの代理委任は、本人のログインとしてカウントされません。

利用しなくなったユーザーは、[メンバー管理] -> [メンバー]で対象のメンバーにチェックを入れ、[ログインを無効にする]をクリックしてログインを停止します。

SSOでログインできる利用者を組織内に限定する​

OAuth SPでは、IdP(アイデンティティプロバイダー)側の任意の組織のアカウントでログインできます。たとえば、[ターゲットドメイン]が[管理画面]のOAuth SPで[自動ユーザー登録]を有効にしていると、管理画面のログインURLが分かれば、IdPのアカウントを持つ誰でも管理画面にログインでき、[登録時にセットされるグループ]の権限で操作できます。

  • 管理画面へのログインにSSOを利用する場合は、組織単位でアクセスを制御できるSAML SPを利用します。
  • 自動ユーザー登録が不要な場合は、[自動ユーザー登録]を無効にし、管理画面で登録したメンバーのみがログインできるようにします。
  • [自動ユーザー登録]を有効にする場合は、[登録時にセットされるグループ]に必要最小限の権限のグループを設定します。

[ターゲットドメイン]が[API]のSSOでも、自動ユーザー登録で付与されるグループをGroupAuthで許可しているエンドポイントは、誰でもリクエストできる状態になります。

管理画面を利用しないグループで管理画面利用不可を有効にする​

会員サイトの会員など、APIからのログインのみを想定している編集ユーザーのグループでも、[管理画面利用不可]にチェックを入れていない場合は、管理画面のURLを知った会員が、同じアカウントで管理画面にログインし、グループの権限の範囲で管理画面の閲覧や操作ができます。

[ユーザー種別]が[編集ユーザー]のグループのうち、管理画面の利用を想定しないグループは、[管理画面利用不可]にチェックを入れます。
[ユーザー種別]が[ログインユーザー]のグループは、もともと管理画面の閲覧やコンテンツの編集ができません。

管理画面にログインできるグループは、セキュリティアドバイザリー画面の[セキュリティインベントリ]タブの[管理画面]にある[管理画面にログインできるグループ]で確認できます。会員サイト用のグループなど、意図しないグループが含まれていないかを確認してください。

費用を監視する​

Kurocoには、費用が一定額を超えた場合に自動で利用を停止する機能はありません。ボットからの大量のリクエストなどで費用が増えても、気づくまでAPIやバッチ処理は稼働し続けます。

[環境設定] -> [アカウント設定]の[月次費用監視アラート閾値]を設定すると、月次費用が設定金額を超えた場合にメールで通知されます。通常の月次費用より高めの金額を設定しておくと、想定外の増加に早く気づけます。

関連ドキュメント​


サポート

お探しのページは見つかりましたか?解決しない場合は、問い合わせフォームからお問い合わせいただくか、Slackコミュニティにご参加ください。