このページでは

QWebSocketCorsAuthenticator Class

QWebSocketCorsAuthenticator クラスは、クロスオリジンリクエスト(CORS)用の認証オブジェクトを提供します。詳細...

ヘッダー: #include <QWebSocketCorsAuthenticator>
CMake: find_package(Qt6 REQUIRED COMPONENTS WebSockets)
target_link_libraries(mytarget PRIVATE Qt6::WebSockets)
qmake: QT += websockets

パブリック関数

QWebSocketCorsAuthenticator(const QString &origin)
QWebSocketCorsAuthenticator(const QWebSocketCorsAuthenticator &other)
QWebSocketCorsAuthenticator(QWebSocketCorsAuthenticator &&other)
~QWebSocketCorsAuthenticator()
bool allowed() const
QString origin() const
void setAllowed(bool allowed)
void swap(QWebSocketCorsAuthenticator &other)
QWebSocketCorsAuthenticator &operator=(QWebSocketCorsAuthenticator &&other)
QWebSocketCorsAuthenticator &operator=(const QWebSocketCorsAuthenticator &other)

詳細な説明

QWebSocketCorsAuthenticator クラスは、originAuthenticationRequired() シグナルで使用されます。このクラスは、必要な情報をQWebSocketServer に返送する手段を提供します。これにより、アプリケーションは、どのオリジン URL を許可し、どの URL を許可しないかをきめ細かく制御できます。デフォルトでは、すべてのオリジンが受け入れられます。 きめ細かな制御を行うには、アプリケーションはoriginAuthenticationRequired() シグナルをスロットに接続します。オリジン (QWebSocketCorsAuthenticator::origin()) が受け入れられた場合、QWebSocketCorsAuthenticator::setAllowed(true) を呼び出します。

注: 非ブラウザクライアントを介してサーバーにアクセスする場合、そのクライアントは任意のオリジンヘッダーを設定できるため、オリジンのチェック はあまり意味をなしません。ブラウザクライアントの場合は、サーバーはオリジンの有効性をチェックすべきです。

「WebSocket セキュリティに関する考慮事項」および「QWebSocketServer 」も参照のこと 。

メンバ関数のドキュメント

[explicit] QWebSocketCorsAuthenticator::QWebSocketCorsAuthenticator(const QString &origin)

指定されたorigin を使用して、新しいQCorsAuthenticatorオブジェクトを作成します。

注: デフォルトでは 、allowed() は true を返します。これは、デフォルトではすべてのオリジンが受け入れられることを意味します。

[explicit] QWebSocketCorsAuthenticator::QWebSocketCorsAuthenticator(const QWebSocketCorsAuthenticator &other)

other のコピーを作成します。

[noexcept] QWebSocketCorsAuthenticator::QWebSocketCorsAuthenticator(QWebSocketCorsAuthenticator &&other)

QWebSocketCorsAuthenticator をムーブコンストラクタで生成し、other が指していたのと同じオブジェクトを指すようにします。

[noexcept] QWebSocketCorsAuthenticator::~QWebSocketCorsAuthenticator()

そのオブジェクトを破棄します。

bool QWebSocketCorsAuthenticator::allowed() const

オリジンが許可されている場合は true を返し、そうでない場合は false を返します。

注: デフォルトでは 、すべてのオリジンが許可されます。

関連項目: setAllowed()。

QString QWebSocketCorsAuthenticator::origin() const

この認証子が処理している対象の原点を返します。

void QWebSocketCorsAuthenticator::setAllowed(bool allowed)

そのオリジンを許可または拒否します。allowed を true に設定すると、指定されたオリジンからの接続要求を受け入れます。

allowed を false に設定すると、接続要求を拒否します。

注: デフォルトでは 、すべてのオリジンが受け入れられます。

関連項目 :allowed()

[noexcept] void QWebSocketCorsAuthenticator::swap(QWebSocketCorsAuthenticator &other)

other をこの認証ツールと交換します。

この操作は非常に高速で、失敗することはありません。

[noexcept] QWebSocketCorsAuthenticator &QWebSocketCorsAuthenticator::operator=(QWebSocketCorsAuthenticator &&other)

other をこのインスタンスに割り当てます。

QWebSocketCorsAuthenticator &QWebSocketCorsAuthenticator::operator=(const QWebSocketCorsAuthenticator &other)

この認証オブジェクトにother を割り当てます。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.