내장 장치 인증 클라이언트 흐름에서 기본 사용자 프롬프트를 대체합니다.데이터인스턴스를 가리 킵니다pgprompt사설 토토 사이트device:

typedef struct _pgprompt사설 토토 사이트device

    const char *verification_uri;   / * 방문 할 URI 확인 */
    const char *user_code;          / * 입력 할 사용자 코드 */
    const char *verification_uri_complete;  /* URI의 선택적 조합
                                             * 코드 또는 null */
    int expires_in;         / * 사용자 코드가 만료 될 때까지 */
 pgprompt사설 토토 사이트device;

사설 토토 사이트 장치 권한 부여 흐름포함 할 수 있습니다inlibpq최종 사용자가 브라우저를 사용하여 URL을 방문한 다음 허용하는 코드를 입력해야합니다libpq대신 서버에 연결합니다. 기본 프롬프트는 단순히 인쇄합니다.verification_uri및user_code표준 오류에서. 교체 구현은 선호하는 방법 (예 : GUI)을 사용 하여이 정보를 표시 할 수 있습니다.

이 콜백은 내장 장치 인증 흐름 중에 만 호출됩니다. 응용 프로그램이 a를 설치하는 경우Custom 사설 토토 사이트 흐름또는libpq내장 흐름에 대한 지원으로 구축되지 않았 으며이 authdata 유형은 사용되지 않습니다.

null이 아닌 경우verification_uri_complete제공되면 선택적으로 비 텍스트 검증에 사용될 수 있습니다 (예 : QR 코드를 표시 함). 이 경우 URL 및 사용자 코드는 여전히 최종 사용자에게 표시되어야합니다.이 경우 코드가 공급자가 수동으로 확인하고 URL을 사용하면 비 텍스트 방법을 사용할 수없는 경우에도 URL을 계속할 수 있습니다. 자세한 내용은 섹션 3.3.1 in을 참조하십시오.RFC 8628.

흐름의 사용자 정의 구현을 추가하여 내장 흐름을 대체합니다.설치. 후크는 현재 사용자/발행자/스코프 조합에 대한 베어러 토큰을 직접 반환하거나 차단하지 않고 사용할 수 있거나 다른 콜백을 설정하여 하나를 검색해야합니다..

data인스턴스를 가리 킵니다pg사설 토토 사이트bearerRequest,이 구현에 의해 채워야합니다.

typedef struct pgoauthbearerrequest

    / * 후크 입력 (모든 통화에 따라 상수) */
    const char *OpenID_Configuration; / * OIDC Discovery URL */
    const char *범위;                / * 필수 범위 또는 null */

    / * 후크 출력 */

    /* 콜백 사용자 지정 비동기식 Oauth 흐름을 구현합니다. */
    postgrespollingstatustype ( *async) (pgconn *conn,
                                        struct pgoauthbearerrequest *요청,
                                        SOODTYPE *ALTSOCK);

    /* 콜백 사용자 정의 할당을 정리합니다. */
    void ( *cleanup) (pgconn *conn, struct pgoauthbearerrequest *요청);

    숯 *토큰;   / * 취득한 소지자 토큰 */
    무효 *사용자;    / * 후크 정의 할당 된 데이터 */
 pg사설 토토 사이트bearerRequest;

두 개의 정보가 훅에 제공됩니다.libpq: OpenID_Configuration권한 부여 서버의 지원 흐름을 설명하는 사설 토토 사이트 발견 문서의 URL을 포함합니다.스코프서버에 액세스하는 데 필요한 공간 분리 된 OAUTH 스코프 목록이 포함되어 있습니다. 둘 중 하나 또는 둘 다일 수 있습니다NULL정보를 발견 할 수 없음을 나타냅니다. (이 경우 구현은 다른 미리 구성된 지식을 사용하여 요구 사항을 설정하거나 실패하기로 선택할 수 있습니다.)

후크의 최종 출력은입니다.토큰는 연결에 사용하기 위해 유효한 베어러 토큰을 가리켜 야합니다. (이 토큰은에 의해 발행되어야합니다.Oauth_issuer요청 된 스코프를 보관하거나 서버의 유효성 검사기 모듈에 의해 연결이 거부됩니다.) 할당 된 토큰 문자열은까지 유효합니다libpq연결이 완료되었습니다. 후크는 a를 설정해야합니다.정리libpq더 이상 필요하지 않습니다.

구현이 즉시 a를 생산할 수없는 경우토큰훅으로의 초기 호출 중에를 설정해야합니다.async인증 서버와의 비 차단 통신을 처리하려는 콜백.^[16]이것은 후크에서 돌아 오는 즉시 흐름을 시작하도록 호출됩니다. 콜백이 차단하지 않고 더 많은 진전을 이룰 수 없으면 둘 중 하나를 반환해야합니다pgres_polling_reading또는pgres_polling_writing설정 후*pgsocket진행 상황이 다시 만들 수있을 때 읽거나 쓸 준비가 될 파일 설명 자에게. (이 설명자는를 통해 최상위 폴링 루프에 제공됩니다pqsocket ().) returnpgres_polling_ok설정 후토큰흐름이 완료되면 또는pgres_polling_failed실패를 나타내는 것.

구현은 전화를 걸어서 부기를위한 추가 데이터를 저장할 수 있습니다asyncand정리콜백. 그만큼user포인터 가이 목적을 위해 제공됩니다.libpq| 내용은 내용을 만지지 않으며 애플리케이션은 편의상이를 사용할 수 있습니다. (토큰 청소 중에 할당을 해제해야합니다.)