QAbstractOAuth2 Class
La clase `QAbstractOAuth2` es la base de todas las implementaciones de los métodos de autenticación OAuth 2. Más información...
| Encabezado: | #include <QAbstractOAuth2> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS NetworkAuth) target_link_libraries(mytarget PRIVATE Qt6::NetworkAuth) |
| qmake: | QT += networkauth |
| Heredado de: | QAbstractOAuth |
| Heredado por: | QOAuth2AuthorizationCodeFlow y QOAuth2DeviceAuthorizationFlow |
Tipos públicos
(since 6.9) enum class | NonceMode { Automatic, Enabled, Disabled } |
Propiedades
|
|
Funciones públicas
| QAbstractOAuth2(QObject *parent = nullptr) | |
| QAbstractOAuth2(QNetworkAccessManager *manager, QObject *parent = nullptr) | |
| virtual | ~QAbstractOAuth2() |
| bool | autoRefresh() const |
| void | clearNetworkRequestModifier() |
| QString | clientIdentifierSharedKey() const |
| virtual QUrl | createAuthenticatedUrl(const QUrl &url, const QVariantMap ¶meters = QVariantMap()) |
| QDateTime | expirationAt() const |
| QSet<QByteArray> | grantedScopeTokens() const |
| QString | idToken() const |
| QString | nonce() const |
| QAbstractOAuth2::NonceMode | nonceMode() const |
| std::chrono::seconds | refreshLeadTime() const |
| QString | refreshToken() const |
| QSet<QByteArray> | requestedScopeTokens() const |
| QString | responseType() const |
| QString | scope() const |
| void | setAutoRefresh(bool enable) |
| void | setClientIdentifierSharedKey(const QString &clientIdentifierSharedKey) |
(since 6.9) void | setNetworkRequestModifier(const QAbstractOAuth2::ContextTypeForFunctor<Functor> *context, Functor &&callback) |
| void | setNonce(const QString &nonce) |
| void | setNonceMode(QAbstractOAuth2::NonceMode mode) |
| void | setRefreshLeadTime(std::chrono::seconds leadTime) |
| void | setRefreshToken(const QString &refreshToken) |
| void | setRequestedScopeTokens(const QSet<QByteArray> &tokens) |
| void | setScope(const QString &scope) |
(since 6.5) void | setSslConfiguration(const QSslConfiguration &configuration) |
| void | setState(const QString &state) |
| void | setTokenUrl(const QUrl &tokenUrl) |
| void | setUserAgent(const QString &userAgent) |
(since 6.5) QSslConfiguration | sslConfiguration() const |
| QString | state() const |
| QUrl | tokenUrl() const |
| QString | userAgent() const |
Funciones públicas reimplementadas
(deprecated in 6.11) virtual QNetworkReply * | deleteResource(const QUrl &url, const QVariantMap ¶meters = QVariantMap()) override |
(deprecated in 6.11) virtual QNetworkReply * | get(const QUrl &url, const QVariantMap ¶meters = QVariantMap()) override |
(deprecated in 6.11) virtual QNetworkReply * | head(const QUrl &url, const QVariantMap ¶meters = QVariantMap()) override |
(deprecated in 6.11) virtual QNetworkReply * | post(const QUrl &url, const QVariantMap ¶meters = QVariantMap()) override |
| virtual void | prepareRequest(QNetworkRequest *request, const QByteArray &verb, const QByteArray &body = QByteArray()) override |
(deprecated in 6.11) virtual QNetworkReply * | put(const QUrl &url, const QVariantMap ¶meters = QVariantMap()) override |
Ranuras públicas
(since 6.9) void | refreshTokens() |
Señales
(since 6.9) void | accessTokenAboutToExpire() |
| void | authorizationCallbackReceived(const QVariantMap &data) |
| void | autoRefreshChanged(bool enable) |
| void | clientIdentifierSharedKeyChanged(const QString &clientIdentifierSharedKey) |
(until 6.13) void | error(const QString &error, const QString &errorDescription, const QUrl &uri) |
| void | expirationAtChanged(const QDateTime &expiration) |
| void | grantedScopeTokensChanged(const QSet<QByteArray> &tokens) |
| void | idTokenChanged(const QString &idToken) |
| void | nonceChanged(const QString &nonce) |
| void | nonceModeChanged(QAbstractOAuth2::NonceMode mode) |
| void | refreshLeadTimeChanged(std::chrono::seconds leadTime) |
| void | refreshTokenChanged(const QString &refreshToken) |
| void | requestedScopeTokensChanged(const QSet<QByteArray> &tokens) |
| void | scopeChanged(const QString &scope) |
(since 6.9) void | serverReportedErrorOccurred(const QString &error, const QString &errorDescription, const QUrl &uri) |
(since 6.5) void | sslConfigurationChanged(const QSslConfiguration &configuration) |
| void | stateChanged(const QString &state) |
| void | tokenUrlChanged(const QUrl &tokenUrl) |
| void | userAgentChanged(const QString &userAgent) |
Ranuras protegidas
(since 6.9) void | refreshTokensImplementation() |
Descripción detallada
La clase define la interfaz básica de las clases de autenticación OAuth 2. Al heredar esta clase, puedes crear métodos de autenticación personalizados utilizando el estándar OAuth 2 para diferentes servicios web.
Se puede encontrar una descripción del funcionamiento de OAuth 2 en: El marco de autorización OAuth 2.0
Documentación sobre tipos de miembro
[since 6.9] enum class QAbstractOAuth2::NonceMode
Lista de modos de nonce disponibles.
| Constante | Valor | Descripción |
|---|---|---|
QAbstractOAuth2::NonceMode::Automatic | 0 | El nonce se envía si el « requested scope » contiene « openid ». Este es el modo predeterminado y envía « nonce » solo cuando es relevante para los flujos de autenticación OIDC. |
QAbstractOAuth2::NonceMode::Enabled | 1 | El nonce se envía durante la fase de autorización. |
QAbstractOAuth2::NonceMode::Disabled | 2 | El nonce no se envía durante la fase de autorización. Esto desactiva la protección contra la repetición de la solicitud de autenticación ( id_token ) de OpenID Connect. |
Esta enumeración se introdujo en Qt 6.9.
Véase también « nonce » y «Descripción general de OAuth 2.0».
Documentación de la propiedad
[since 6.9] autoRefresh : bool
Esta propiedad activa o desactiva la actualización automática del token de acceso.
Esta propiedad activa o desactiva la actualización automática del token de acceso. Resulta útil para aplicaciones que requieren una autorización ininterrumpida sin intervención del usuario.
Si esta propiedad está est true, se llamará automáticamente a refreshTokens() cuando el token esté a punto de caducar y exista un refreshToken válido.
Esta enumeración se introdujo en Qt 6.9.
Funciones de acceso:
| bool | autoRefresh() const |
| void | setAutoRefresh(bool enable) |
Señal de notificador:
| void | autoRefreshChanged(bool enable) |
Véase también refreshLeadTime y accessTokenAboutToExpire().
clientIdentifierSharedKey : QString
Esta propiedad contiene la clave compartida del cliente que se utiliza como contraseña si el servidor exige autenticación para solicitar el token.
Funciones de acceso:
| QString | clientIdentifierSharedKey() const |
| void | setClientIdentifierSharedKey(const QString &clientIdentifierSharedKey) |
Señal del notificador:
| void | clientIdentifierSharedKeyChanged(const QString &clientIdentifierSharedKey) |
[read-only] expiration : QDateTime
Esta propiedad contiene la hora de caducidad del token de acceso actual. Un valor no válido significa que el servidor de autorización no ha proporcionado una hora de caducidad válida.
Funciones de acceso:
| QDateTime | expirationAt() const |
Señal de notificación:
| void | expirationAtChanged(const QDateTime &expiration) |
Véase también QDateTime::isValid().
[read-only, since 6.9] grantedScopeTokens : QSet<QByteArray>
Esta propiedad contiene el ámbito concedido por el servidor de autorización.
El ámbito solicitado y el concedido pueden diferir. Es posible que el usuario final haya optado por conceder solo un subconjunto del ámbito, o que las políticas del lado del servidor lo hayan modificado. La aplicación debe estar preparada para gestionar esta situación y comprobar el ámbito concedido para determinar si afecta a la lógica de la aplicación.
El servidor puede omitir por completo la indicación del ámbito concedido, tal y como se define en el RFC 6749. En este caso, la implementación asume que el ámbito concedido es el mismo que el solicitado.
Esta enumeración se introdujo en Qt 6.9.
Funciones de acceso:
| QSet<QByteArray> | grantedScopeTokens() const |
Señal del notificador:
| void | grantedScopeTokensChanged(const QSet<QByteArray> &tokens) |
Véase también QAbstractOAuth2::requestedScopeTokens.
[read-only, since 6.9] idToken : QString
Esta propiedad contiene el token de identificación de OpenID Connect recibido.
Esta enumeración se introdujo en Qt 6.9.
Funciones de acceso:
| QString | idToken() const |
Señal de notificación:
| void | idTokenChanged(const QString &idToken) |
Véase también « NonceMode », « nonce » y «Compatibilidad de Qt con OpenID Connect».
[since 6.9] nonce : QString
Esta propiedad contiene la cadena enviada al servidor durante la autenticación. El «nonce» se utiliza para asociar las respuestas de token pertinentes (en concreto, el token de autenticación de OpenID Connect id_token ) con la fase de autorización.
El objetivo principal del nonce es mitigar los ataques de repetición. Garantiza que las respuestas de token recibidas correspondan a las solicitudes de autenticación iniciadas por la aplicación, lo que impide que los atacantes reutilicen los tokens en contextos no autorizados. Por lo tanto, es importante incluir la verificación del nonce como parte de la validación del token.
En la práctica, los proveedores de servidores de autorización pueden rechazar la solicitud de OpenID Connect si no se proporciona un nonce en la solicitud de autorización.
El token en sí es una cadena opaca y, para garantizar la máxima compatibilidad, solo debe contener caracteres aptos para URL. Además, el token debe proporcionar una entropía adecuada para que los atacantes no puedan adivinarlo. No existen límites de tamaño estrictos para el nonce, y los proveedores de servidores de autorización pueden imponer sus propios tamaños mínimos y máximos.
Aunque el « nonce » se puede configurar manualmente, las clases de Qt generarán un nonce de 32 caracteres when needed si no se ha establecido ninguno.
Esta enumeración se introdujo en Qt 6.9.
Funciones de acceso:
| QString | nonce() const |
| void | setNonce(const QString &nonce) |
Señal del notificador:
| void | nonceChanged(const QString &nonce) |
Véase también « nonceMode » y «Compatibilidad de Qt con OpenID Connect».
[since 6.9] nonceMode : NonceMode
Esta propiedad indica el modo de nonce actual (si se utiliza o no el nonce).
Esta enumeración se introdujo en Qt 6.9.
Funciones de acceso:
| QAbstractOAuth2::NonceMode | nonceMode() const |
| void | setNonceMode(QAbstractOAuth2::NonceMode mode) |
Señal del notificador:
| void | nonceModeChanged(QAbstractOAuth2::NonceMode mode) |
Véase también NonceMode y nonce.
[since 6.9] refreshLeadTime : std::chrono::seconds
Esta propiedad define con cuánta antelación se emite la señal « accessTokenAboutToExpire()» respecto a la caducidad del token de acceso.
Esta propiedad especifica el intervalo de tiempo (en segundos) antes de la caducidad del token de acceso actual, en el que se emite la señal accessTokenAboutToExpire(). El valor establecido para esta propiedad debe ser un intervalo de tiempo positivo.
Este intervalo permite a la aplicación actualizar el token con suficiente antelación, lo que garantiza una autorización continua sin interrupciones.
Si esta propiedad no se establece explícitamente, o si el `leadTime` proporcionado es mayor que la vida útil del token, el `leadTime` se establece por defecto en el 5 % de la vida útil restante del token, pero no menos de 10 segundos antes de la caducidad (dejando tiempo para que se complete la solicitud de actualización).
Nota: La señal«expiration» solo funciona si el servidor de autorización ha proporcionado una hora de caducidad adecuada.
Esta enumeración se introdujo en Qt 6.9.
Funciones de acceso:
| std::chrono::seconds | refreshLeadTime() const |
| void | setRefreshLeadTime(std::chrono::seconds leadTime) |
Señal del notificador:
| void | refreshLeadTimeChanged(std::chrono::seconds leadTime) |
Véase también autoRefresh.
refreshToken : QString
Esta propiedad contiene el token de actualización que se utiliza para obtener nuevos tokens de acceso.
Los tokens de actualización suelen tener una vida útil más larga que los tokens de acceso, por lo que conviene guardarlos para utilizarlos más adelante.
Funciones de acceso:
| QString | refreshToken() const |
| void | setRefreshToken(const QString &refreshToken) |
Señal de notificador:
| void | refreshTokenChanged(const QString &refreshToken) |
Véase también setRefreshToken().
[since 6.9] requestedScopeTokens : QSet<QByteArray>
Esta propiedad contiene el ámbito deseado, que define los permisos solicitados por el cliente.
Nota: Los tokensde ámbito se limitan a un subconjunto de caracteres US-ASCII imprimibles. No se admite el uso de caracteres fuera de este rango.
Esta enumeración se introdujo en Qt 6.9.
Funciones de acceso:
| QSet<QByteArray> | requestedScopeTokens() const |
| void | setRequestedScopeTokens(const QSet<QByteArray> &tokens) |
Señal de notificador:
| void | requestedScopeTokensChanged(const QSet<QByteArray> &tokens) |
Véase también QAbstractOAuth2::grantedScopeTokens.
[until 6.13] scope : QString
Está previsto que esta enumeración quede obsoleta en la versión 6.13.
Utiliza en su lugar las propiedades « requestedScopeTokens » y « grantedScopeTokens ». Esta propiedad se eliminará en Qt 7.
Esta propiedad contiene el ámbito deseado, que define los permisos solicitados por el cliente.
El valor del ámbito se actualiza al valor del ámbito concedido por el servidor de autorización. En caso de una respuesta de ámbito vacía, se asume que el ámbito solicitado ha sido concedido y no cambia.
El hecho de que esta propiedad desempeñe dos funciones diferentes —primero como ámbito solicitado y después como ámbito concedido— es un vestigio histórico. Se recomienda que todo el código nuevo utilice QAbstractOAuth2::requestedScopeTokens y QAbstractOAuth2::grantedScopeTokens.
Funciones de acceso:
| QString | scope() const |
| void | setScope(const QString &scope) |
Señal del notificador:
| void | scopeChanged(const QString &scope) |
Véase también QAbstractOAuth2::grantedScopeTokens y QAbstractOAuth2::requestedScopeTokens.
state : QString
Esta propiedad contiene la cadena enviada al servidor durante la autenticación. El estado se utiliza para identificar y validar la solicitud cuando se recibe la llamada de retorno.
Si no se ha establecido ningún estado al inicio del flujo de autorización, se genera automáticamente un estado aleatorio de 32 caracteres. Esta es la opción predeterminada y la recomendada.
Este estado es la principal protección contra la falsificación de solicitudes entre sitios(CSRF) y, por lo tanto, debe contener un grado suficiente de aleatoriedad. Si lo estableces manualmente, considera utilizar al menos 32 caracteres aleatorios.
Hay ciertos caracteres que no están permitidos en el elemento «state» (véase RFC 6749). El uso de caracteres no permitidos podría provocar una discrepancia involuntaria en el estado y un fallo en la autorización OAuth 2. Por lo tanto, si intentas establecer un valor que contenga caracteres no permitidos, el estado se ignorará y se registrará una advertencia.
Funciones de acceso:
| QString | state() const |
| void | setState(const QString &state) |
Señal del notificador:
| void | stateChanged(const QString &state) |
[since 6.9] tokenUrl : QUrl
Esta propiedad contiene la URL del punto final de tokens que se utiliza para obtener tokens. Dependiendo del caso de uso y de la compatibilidad del servidor de autorización, estos tokens pueden ser tokens de acceso, tokens de actualización y tokens de identificación.
Normalmente, los tokens se obtienen una vez finalizada la fase de autorización, y el punto final de tokens también puede utilizarse para actualizar los tokens según sea necesario.
Por ejemplo, QOAuth2AuthorizationCodeFlow utiliza esta URL para enviar una solicitud de token de acceso, y QOAuth2DeviceAuthorizationFlow utiliza esta URL para consultar si hay un token de acceso disponible.
Esta enumeración se introdujo en Qt 6.9.
Funciones de acceso:
| QUrl | tokenUrl() const |
| void | setTokenUrl(const QUrl &tokenUrl) |
Señal de notificador:
| void | tokenUrlChanged(const QUrl &tokenUrl) |
userAgent : QString
Esta propiedad contiene el encabezado User-Agent utilizado para crear las solicitudes de red.
El valor por defecto es «QtOAuth/1.0 (+https://www.qt.io)».
Funciones de acceso:
| QString | userAgent() const |
| void | setUserAgent(const QString &userAgent) |
Señal del notificador:
| void | userAgentChanged(const QString &userAgent) |
Documentación de funciones de miembro
[explicit] QAbstractOAuth2::QAbstractOAuth2(QObject *parent = nullptr)
Crea un objeto QAbstractOAuth2 utilizando parent como objeto padre.
[explicit] QAbstractOAuth2::QAbstractOAuth2(QNetworkAccessManager *manager, QObject *parent = nullptr)
Crea un objeto QAbstractOAuth2 utilizando parent como objeto padre y establece manager como gestor de acceso a la red.
[virtual noexcept] QAbstractOAuth2::~QAbstractOAuth2()
Elimina la instancia de « QAbstractOAuth2 ».
[signal, since 6.9] void QAbstractOAuth2::accessTokenAboutToExpire()
La señal se emite cuando el token de acceso está a punto de caducar.
Para emitir esta señal es necesario que el token de acceso tenga una fecha de caducidad válida. Una alternativa para gestionar esta señal manualmente es utilizar autoRefresh.
Esta función se introdujo en Qt 6.9.
Véase también refreshLeadTime, autoRefresh y refreshTokens().
[signal] void QAbstractOAuth2::authorizationCallbackReceived(const QVariantMap &data)
Señal emitida cuando el servidor de respuesta recibe la llamada de retorno de autorización del servidor: ` data ` contiene los valores recibidos del servidor.
void QAbstractOAuth2::clearNetworkRequestModifier()
Borra el modificador de solicitud de red.
Véase también setNetworkRequestModifier().
[virtual invokable] QUrl QAbstractOAuth2::createAuthenticatedUrl(const QUrl &url, const QVariantMap ¶meters = QVariantMap())
La URL devuelta se basa en url, combinándola con el parameters proporcionado y el token de acceso.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[signal, until 6.13] void QAbstractOAuth2::error(const QString &error, const QString &errorDescription, const QUrl &uri)
Está previsto que esta función quede obsoleta en la versión 6.13.
Utiliza en su lugar ` serverReportedErrorOccurred `
Señal emitida cuando el servidor de autorización notifica un error al procesar una solicitud de autorización o de token, incluida una solicitud de actualización de token, tal y como se define en la respuesta de error del RFC 6749.
error es el nombre del error; errorDescription describe el error y uri es un URI opcional que contiene más información sobre el error.
Véase también QAbstractOAuth::requestFailed() y QAbstractOAuth2::serverReportedErrorOccurred().
[override virtual] void QAbstractOAuth2::prepareRequest(QNetworkRequest *request, const QByteArray &verb, const QByteArray &body = QByteArray())
Reimplementa: QAbstractOAuth::prepareRequest(QNetworkRequest *request, const QByteArray &verb, const QByteArray &body).
QString QAbstractOAuth2::refreshToken() const
Obtiene el token de actualización actual.
Los tokens de actualización suelen tener una vigencia mayor que los tokens de acceso, por lo que conviene guardarlos para utilizarlos más adelante.
Devuelve el token de actualización actual o una cadena vacía, si no hay ningún token de actualización disponible.
Nota: Funcióngetter para la propiedad refreshToken.
Véase también setRefreshToken().
[slot, since 6.9] void QAbstractOAuth2::refreshTokens()
Llama a esta función para actualizar los tokens. La función llama a refreshTokensImplementation() para llevar a cabo la actualización propiamente dicha.
Esta función se introdujo en Qt 6.9.
Véase también refreshTokensImplementation() y autoRefresh.
[protected slot, since 6.9] void QAbstractOAuth2::refreshTokensImplementation()
Esta ruta es llamada por refreshTokens() para enviar la solicitud de actualización del token.
Las clases derivadas deben reimplementar este slot para admitir la actualización del token:
class MyClass : public QAbstractOAuth2
{
...
protected Q_SLOTS:
void refreshTokensImplementation() QT7_ONLY(override);
};
void MyClass::refreshTokensImplementation()
{
qDebug("refresh");
}Esta función se introdujo en Qt 6.9.
Véase también autoRefresh y accessTokenAboutToExpire().
QString QAbstractOAuth2::responseType() const
Devuelve el «response_type » utilizado.
[signal, since 6.9] void QAbstractOAuth2::serverReportedErrorOccurred(const QString &error, const QString &errorDescription, const QUrl &uri)
Señal emitida cuando el servidor de autorización notifica un error al procesar una solicitud de autorización o de token, incluida una solicitud de actualización de token, tal y como se define en la respuesta de error del RFC 6749.
error es el nombre del error; errorDescription describe el error y uri es un URI opcional que contiene más información sobre el error.
Para detectar todos los errores, incluidos estos errores definidos en el RFC, con una única señal, utilice QAbstractOAuth::requestFailed().
Esta función se introdujo en Qt 6.9.
[since 6.9] template <typename Functor> requires if_compatible_callback<Functor> void QAbstractOAuth2::setNetworkRequestModifier(const QAbstractOAuth2::ContextTypeForFunctor<Functor> *context, Functor &&callback)
Establece la función de modificación de solicitudes de red en callback. Esta función se utiliza para personalizar las solicitudes de red enviadas al servidor.
callback Debe implementar la firma void(QNetworkRequest&, QAbstractOAuth::Stage). El objeto QNetworkRequest proporcionado puede modificarse directamente y se utiliza justo después de que finalice la llamada de retorno. callback puede ser un puntero a función, una lambda, una función miembro o cualquier objeto invocable. El objeto QAbstractOAuth::Stage proporcionado puede utilizarse para comprobar a qué fase corresponde la solicitud (solicitud de token, solicitud de actualización de token o solicitud de autorización en el caso de QOAuth2DeviceAuthorizationFlow).
context controla la vida útil de las llamadas y evita el acceso a recursos desasignados en caso de que context se destruya. En otras palabras, si el objeto proporcionado como contexto se destruye, las funciones de devolución de llamada no se ejecutarán. context debe apuntar a un QObject válido (y, en caso de que la función de devolución de llamada sea una función miembro, debe tenerla realmente). Dado que los resultados de la función de devolución de llamada se utilizan de forma inmediata, context debe residir en el mismo hilo que la instancia de QAbstractOAuth2.
Esta función se introdujo en Qt 6.9.
Véase también clearNetworkRequestModifier() y QNetworkRequest.
void QAbstractOAuth2::setRefreshToken(const QString &refreshToken)
Establece el nuevo token de actualización refreshToken que se va a utilizar.
Se puede utilizar un token de actualización personalizado para actualizar el token de acceso mediante este método y, a continuación, el token de acceso se puede actualizar mediante refreshTokens().
Nota: Funciónde asignación para la propiedad refreshToken.
Véase también refreshToken().
[since 6.5] void QAbstractOAuth2::setSslConfiguration(const QSslConfiguration &configuration)
Establece el protocolo TLS configuration que se utilizará al establecer una conexión TLS recíproca entre el cliente y el servidor de autorización.
Esta función se introdujo en Qt 6.5.
Véase también sslConfiguration() y sslConfigurationChanged().
[since 6.5] QSslConfiguration QAbstractOAuth2::sslConfiguration() const
Devuelve la configuración TLS que se utilizará al establecer una conexión TLS mutua entre el cliente y el servidor de autorización.
Esta función se introdujo en Qt 6.5.
Véase también setSslConfiguration() y sslConfigurationChanged().
[signal, since 6.5] void QAbstractOAuth2::sslConfigurationChanged(const QSslConfiguration &configuration)
La señal se emite cuando cambia la configuración de TLS. El parámetro ` configuration ` contiene la nueva configuración de TLS.
Esta función se introdujo en Qt 6.5.
Véase también sslConfiguration() y setSslConfiguration().
© 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.