Replaces the default user prompt during the builtin device authorization client flow. <replaceable>data</replaceable> points to an instance of <symbol>PGpromptOAuthDevice</symbol>: 《機械翻訳》組み込みデフォルト許可クライアントプロンプト中にユーザフローデバイスを置き換えます。 dataはPGpromptOAuthDevice:のインスタンスを指します。

typedef struct _PGpromptOAuthDevice
{
    const char *verification_uri;   /* verification URI to visit */
    const char *user_code;          /* user code to enter */
    const char *verification_uri_complete;  /* optional combination of URI and
                                             * code, or NULL */
    int         expires_in;         /* seconds until user code expires */
} PGpromptOAuthDevice;

The OAuth Device Authorization flow which <link linkend="configure-option-with-libcurl">can be included</link> in <application>libpq</application> requires the end user to visit a URL with a browser, then enter a code which permits <application>libpq</application> to connect to the server on their behalf. The default prompt simply prints the <literal>verification_uri</literal> and <literal>user_code</literal> on standard error. Replacement implementations may display this information using any preferred method, for example with a GUI. 《機械翻訳》libpqに含めることができるOAuthデバイス認証フローは、エンドユーザがブラウザのあるURLにアクセスし、libpqがサーバに接続することを許可するコードを入力する必要があります。 デフォルトプロンプトは、単にverification_uriおよびuser_code標準エラーのを出力します。 置換実装では、GUIのある例に対して、任意の優先メソッドを使用してこの情報をディスプレイする場合があります。

This callback is only invoked during the builtin device authorization flow. If the application installs a <link linkend="libpq-oauth-authdata-oauth-bearer-token">custom OAuth flow</link>, or <application>libpq</application> was not built with support for the builtin flow, this authdata type will not be used. 《機械翻訳》このコールバックは、組み込みのデバイス許可フロー中にのみ呼び出されます。 アプリケーションがカスタムOAuthフローをインストールする場合、またはlibpq組み込みのフロー用にサポートで構築されていない場合、このauthdataタイプは使用されません。

If a non-NULL <structfield>verification_uri_complete</structfield> is provided, it may optionally be used for non-textual verification (for example, by displaying a QR code). The URL and user code should still be displayed to the end user in this case, because the code will be manually confirmed by the provider, and the URL lets users continue even if they can't use the non-textual method. For more information, see section 3.3.1 in <ulink url="https://datatracker.ietf.org/doc/html/rfc8628#section-3.3.1">RFC 8628</ulink>. 《機械翻訳》非NULL verification_uri_completeが提供されている場合は、オプションで非テキストの確認例の場合はQRコードの表示に使用できます。 コードはプロバイダによって手動で確認されるため、URLとユーザコードはこのケースのエンドユーザに表示される必要があります。 URLを使用すると、ユーザは非テキストメソッドを使用できない場合でも続行できます。 詳細は、RFC 8628のセクション3.3.1を参照してください。

Adds a custom implementation of a flow, replacing the builtin flow if it is <link linkend="configure-option-with-libcurl">installed</link>. The hook should either directly return a Bearer token for the current user/issuer/scope combination, if one is available without blocking, or else set up an asynchronous callback to retrieve one. 《機械翻訳》フローのカスタム実装を追加し、組込みフローインストールされている場合を置き換えます。 フックは、ブロッキングなしで使用可能な場合は、現在ユーザ/発行者/スコープの組合せのベアラトークンを直接結果するか、それを取得するための非同期コールバックを設定する必要があります。

<replaceable>data</replaceable> points to an instance of <symbol>PGoauthBearerRequest</symbol>, which should be filled in by the implementation: 《機械翻訳》dataはPGoauthBearerRequestのインスタンスを指し、これは実装:によって記入されるべきである。

typedef struct PGoauthBearerRequest
{
    /* Hook inputs (constant across all calls) */
    const char *openid_configuration; /* OIDC discovery URL */
    const char *scope;                /* required scope(s), or NULL */

    /* Hook outputs */

    /* Callback implementing a custom asynchronous OAuth flow. */
    PostgresPollingStatusType (*async) (PGconn *conn,
                                        struct PGoauthBearerRequest *request,
                                        SOCKTYPE *altsock);

    /* Callback to clean up custom allocations. */
    void        (*cleanup) (PGconn *conn, struct PGoauthBearerRequest *request);

    char       *token;   /* acquired Bearer token */
    void       *user;    /* hook-defined allocated data */
} PGoauthBearerRequest;

Two pieces of information are provided to the hook by <application>libpq</application>: <replaceable>openid_configuration</replaceable> contains the URL of an OAuth discovery document describing the authorization server's supported flows, and <replaceable>scope</replaceable> contains a (possibly empty) space-separated list of OAuth scopes which are required to access the server. Either or both may be <literal>NULL</literal> to indicate that the information was not discoverable. (In this case, implementations may be able to establish the requirements using some other preconfigured knowledge, or they may choose to fail.) 《機械翻訳》次の2つの情報がlibpqによってフックに提供されます。 openid_設定包含は、認可サーバがサポートするフローを記述するOAuthディスカバリドキュメントのURLであり、スコープ包含は、サーバをアクセス化するために必要なOAuthスコープのスペースで区切られた（空の場合もある）リストです。 いずれかまたは両方がNULL情報が検出できなかったことを示すためである可能性があります。 （このケースでは、実装は他の事前設定された知識を使用して要件を確立できる場合もあれば、失敗することを選択する場合もあります。）

The final output of the hook is <replaceable>token</replaceable>, which must point to a valid Bearer token for use on the connection. (This token should be issued by the <xref linkend="libpq-connect-oauth-issuer"/> and hold the requested scopes, or the connection will be rejected by the server's validator module.) The allocated token string must remain valid until <application>libpq</application> is finished connecting; the hook should set a <replaceable>cleanup</replaceable> callback which will be called when <application>libpq</application> no longer requires it. 《機械翻訳》フックの最終出力はtokenです。 これは、コネクションで使用するために有効なベアラトークンにポイントする必要があります。 （このトークンはoauth_issuerによって発行され、要求されたスコープを保持する必要があります。 そうしないと、コネクションはサーバのバリデータモジュールによって拒否されます。） 割り当てられたトークン文字列は、libpqが接続を完了するまで有効である必要があります。 フックは、libpq必要としなくなったときに呼び出されるコールバックを設定する必要があります。 cleanup

If an implementation cannot immediately produce a token during the initial call to the hook, it should set the async callback to handle nonblocking communication with the authorization server. ^[16] This will be called to begin the flow immediately upon return from the hook. When the callback cannot make further progress without blocking, it should return either PGRES_POLLING_READING or PGRES_POLLING_WRITING after setting *pgsocket to the file descriptor that will be marked ready to read/write when progress can be made again. (This descriptor is then provided to the top-level polling loop via PQsocket().) Return PGRES_POLLING_OK after setting token when the flow is complete, or PGRES_POLLING_FAILED to indicate failure.

Implementations may wish to store additional data for bookkeeping across calls to the <replaceable>async</replaceable> and <replaceable>cleanup</replaceable> callbacks. The <replaceable>user</replaceable> pointer is provided for this purpose; <application>libpq</application> will not touch its contents and the application may use it at its convenience. (Remember to free any allocations during token cleanup.) 《機械翻訳》実装によっては、asyncおよびcleanup callbacks. userデータはこの目的のために提供されています。 libpqはその内容に触れることはなく、ポインタは都合のよいときにそれを使用することができます。 アプリケーションクリーンアップ中に割り当てられたものをフリーすることを忘れないでください。 への呼び出し全体にわたって簿記のために追加のトークンを格納することを望む場合があります。