認証(ベリフィケーション)

「認証」を開く

サイドバー(またはモジュール一覧)の「サーバー管理」グループにある「認証」を開きます。

「機能の有効化」をオンにする

ページ最上部にある「機能の有効化」スイッチをオンにします。これをオンにしないと認証は動作しません。

「コマンド権限設定」で /verification setup を確認する

「コマンド権限設定」のセクションを開くと、/verification setup(認証パネルを作成・設置するためのコマンド)が一覧にあります。項目を開くと、次のような設定ができます。

• 「コマンドを有効化」: このコマンド自体を使えるようにします。
• 「個別権限設定を有効化」: オンにすると BotShade 独自の権限設定で判定し、オフのときは Discord の標準的な権限で判定します。
• 「Discord権限より個別設定を優先」: 個別権限設定を Discord の既存権限より優先して強制適用します(危険な設定のため、確認ダイアログが表示されます)。

通常はサーバー管理者だけがパネルを設置できれば十分です。誰でもパネルを作れてしまわないよう、必要に応じて権限を絞り込んでください。

「新しい認証設定を追加」でサーバーを追加する

「認証パネル設定」の中にある「新しい認証設定を追加」を開きます。「対象サーバー」でパネルを設置したいサーバーを選び、「追加」ボタンをクリックします。追加すると、そのサーバーの設定欄(アコーディオン)が下に並びます。

サーバーの設定欄を開き、「認証機能の有効化」をオンにする

追加したサーバーの設定欄(アコーディオン)を開きます。先頭に「認証機能の有効化」スイッチがあります。これをオンにすると、そのサーバー向けの詳細設定(認証チャンネル・認証ロールなど)が表示されます。オフのままだと詳細設定は表示されません。

各サーバーの設定欄の見出しでは、サーバーの ID と認証の有効/無効状態を一目で確認できます。

「認証チャンネル」と「認証ロール」を指定する

詳細設定の上段で、次の 2 つを選びます。

• 「認証チャンネル」: 認証パネルを設置するテキストチャンネルを選びます。メンバーはこのチャンネルでボタンをクリックして認証します。
• 「認証ロール」: 認証に成功したメンバーへ自動で付与するロールを選びます。

どちらのセレクターも、まずサーバーを選んでからチャンネル/ロールの一覧が表示されます。一覧から選ぶほか、下部の「id で直接入力」欄に Channel ID / Role ID を貼り付けて「適用」をクリックする方法もあります。

「認証タイプ」と「ボタンのラベル」を設定する

詳細設定の下段で、認証の方式とボタンの文言を決めます。

• 「認証タイプ」: 「ボタン認証」と「計算認証」から選べます。ボタン認証はクリックで即時に認証が完了し、計算認証はかんたんな計算問題に正解すると認証が完了します。
• 「ボタンのラベル」: 認証パネルに表示されるボタンの文言を入力します。新しく設定を追加した直後は「認証」が初期値として入っています。「例: 認証 / Verify」のように、メンバーに分かりやすい言葉に変更できます。ボタンのラベルは最大 80 文字まで設定でき、空欄にはできません。

「埋め込みメッセージ設定」で案内文を作成する

「埋め込みメッセージ設定」で、認証パネルに表示する案内メッセージ(埋め込み)を作り込みます。タブを切り替えながら、次のような項目を設定できます。

• 基本設定: タイトル、タイトル URL、説明(Description、Markdown 対応)、カラー(枠の色)。
• 著者 (Author): 著者名、著者 URL、アイコン URL。
• 画像設定: 画像 URL(メイン画像)、サムネイル URL。
• フッター: フッターテキスト、フッターアイコン URL、タイムスタンプ表示の ON/OFF。
• フィールド: 「フィールドを追加」で名前と値の組を追加できます(最大 25 個)。各フィールドは「Inline」で横並び表示にもできます。

入力すると、すぐ下(またはモバイルでは「プレビューを開く」ボタン)に Discord 上での見え方のプレビューが表示されます。「🖥️ PC」「📱 Mobile」を切り替えて、両方の見た目を確認できます。「認証を受けるとどうなるか」「規約への同意が必要か」など、メンバーに伝えたい案内をここに記載しましょう。

「保存」する

設定を変更すると、画面下部に未保存の変更を知らせるバーが表示されます。「保存」ボタンをクリックすると設定が保存されます。やり直したいときは「破棄」ボタンで変更を取り消せます。

/verification setup を実行する

設定を保存したら、対象サーバーの Discord 上で Bot のコマンド /verification setup を実行します。これにより、「認証チャンネル」で指定したチャンネルに、作成した埋め込みメッセージと「ボタンのラベル」のボタンが付いた認証パネルが設置されます。

動作を確認する

設置されたパネルのボタンをクリックし、認証成功時に「認証ロール」が付与されるかを確認します。期待どおりにロールが付かない場合は、「認証チャンネル」「認証ロール」が正しく設定・保存されているか、/verification setup のコマンドが有効になっているかを見直してください。

メンバーがパネルのボタンをクリックする

認証チャンネルに設置されたパネルのボタンを、メンバーがクリックします。

認証ロールがその場で付与される

認証が有効で、認証ロールが正しく設定されていれば、その場でロールが付与されます。完了すると、本人だけに見える(エフェメラルな)メッセージで次の文言が表示されます。

✅ 認証が完了しました！ {role_mention} を付与しました。

{role_mention} の部分には、実際に付与された認証ロールの名前が入ります。

メンバーがパネルのボタンをクリックする

ボタンをクリックすると、計算問題の入力画面(モーダル)が表示されます。問題は A + B = ? のような形式で、クリックするたびに新しい問題が生成されます。

答えを入力する

計算結果を半角の数字で入力します。正解すると、本人だけに見えるメッセージで次の文言が表示され、認証ロールが付与されます。

✅ 正解です！認証が完了しました。 {role_mention} を付与しました。

不正解だった場合は次の文言が表示されます。もう一度ボタンをクリックして、新しい問題に挑戦してください。

❌ 不正解です。もう一度やり直してください。

数字以外を入力した場合は 数字を入力してください。 と表示されます。