GLOBUS_GSI_PROXY_SIGN_REQ(3)

💖 globus_gsi_proxy_operations — Proxy Operations 💖

okay bestie, welcome to the globus_gsi_proxy_operations page, straight out of the Library Functions Manual (globus_gsi..._operations(3), if we're being formal, which we are not). This is the module where you initiate a proxy operation. 🎀

---

✨ NAME ✨

globus_gsi_proxy_operations — Proxy Operations

• Initiate a proxy operation.

---

🌸 SYNOPSIS 🌸

Functions

globus_result_t globus_gsi_proxy_create_req (globus_gsi_proxy_handle_t
    handle, BIO *output_bio)

Create a proxy credential request.

globus_result_t globus_gsi_proxy_inquire_req (globus_gsi_proxy_handle_t
    handle, BIO *input_bio)

Inquire a proxy credential request.

globus_result_t globus_gsi_proxy_resign_cert (globus_gsi_proxy_handle_t
    handle, globus_gsi_cred_handle_t issuer_credential,
    globus_gsi_cred_handle_t peer_credential, globus_gsi_cred_handle_t
    *resigned_credential)

Resign an existing certificate into a proxy.

globus_result_t globus_gsi_proxy_sign_req (globus_gsi_proxy_handle_t
    handle, globus_gsi_cred_handle_t issuer_credential, BIO *output_bio)

Sign a proxy certificate request.

globus_result_t globus_gsi_proxy_create_signed
    (globus_gsi_proxy_handle_t handle, globus_gsi_cred_handle_t issuer,
    globus_gsi_cred_handle_t *proxy_credential)

Create Signed Proxy Certificate.

globus_result_t globus_gsi_proxy_assemble_cred
    (globus_gsi_proxy_handle_t handle, globus_gsi_cred_handle_t
    *proxy_credential, BIO *input_bio)

Assemble a proxy credential.

---

🦋 Detailed Description 🦋

Initiate a proxy operation.

This module contains the API functions for a user to request proxy request generation, proxy request inspection and proxy request signature. That's the whole vibe. Three little jobs, all extremely slay. ✨

---

👑 Function Documentation 👑

💅 globus_result_t globus_gsi_proxy_assemble_cred (globus_gsi_proxy_handle_t handle, globus_gsi_cred_handle_t * proxy_credential, BIO * input_bio)

Assemble a proxy credential.

This function assembles a proxy credential. No cap, that's literally what it does. It reads a signed proxy certificate and an associated certificate chain from the input_bio, and combines them with a private key that was previously generated by a call to globus_gsi_proxy_create_req(). The resulting credential then gets handed back to you through the proxy_credential parameter. it's giving ✨assembly✨.

Parameters

• handle — A GSI Proxy handle to use for the assemble operation.
• proxy_credential — This parameter will contain the assembled credential upon successful return.
• input_bio — A BIO to read a signed certificate and corresponding certificate chain from.

Returns

GLOBUS_SUCCESS if no error occurred, an error object ID otherwise.

---

🌈 globus_result_t globus_gsi_proxy_create_req (globus_gsi_proxy_handle_t handle, BIO * output_bio)

Create a proxy credential request.

This function creates a proxy credential request — that's an unsigned certificate plus the matching private key — all based on the handle you pass in. 🫶

The public part of the request gets written to the BIO you supply in the output_bio parameter. And then, once the request is written, the PROXYCERTINFO extension that lives inside the handle also gets written to the BIO. two for one, obsessed.

The proxy handle is updated with the private key. 🔑

Parameters

• handle — A GSI Proxy handle to use for the request operation.
• output_bio — A BIO to write the resulting request structure to.

Returns

GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned.

---

🎀 globus_result_t globus_gsi_proxy_create_signed (globus_gsi_proxy_handle_t handle, globus_gsi_cred_handle_t issuer, globus_gsi_cred_handle_t * proxy_credential)

Create Signed Proxy Certificate.

Parameters

• handle — The proxy handle used to create and sign the proxy certificate.
• issuer — The issuing credential, used for signing the proxy certificate.
• proxy_credential — The new proxy credential, containing the signed cert, private key, etc.

Returns

GLOBUS_SUCCESS if no error occurred, an error object ID otherwise.

---

💜 globus_result_t globus_gsi_proxy_inquire_req (globus_gsi_proxy_handle_t handle, BIO * input_bio)

Inquire a proxy credential request.

This function reads the public part of a proxy credential request from input_bio, and if that request contains a ProxyCertInfo extension, it updates the handle with all the info contained in that extension. like, it's just checking. lowkey nosy but in a helpful way. 🙈

Parameters

• handle — A GSI Proxy handle to use for the inquire operation.
• input_bio — A BIO to read a request structure from.

Returns

GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned.

---

⭐ globus_result_t globus_gsi_proxy_resign_cert (globus_gsi_proxy_handle_t handle, globus_gsi_cred_handle_t issuer_credential, globus_gsi_cred_handle_t peer_credential, globus_gsi_cred_handle_t * resigned_credential)

Resign an existing certificate into a proxy.

This function uses the public key in an existing certificate to create a new proxy certificate chained to the issuer's credentials. ✨ This operation will add a ProxyCertInfo extension to the proxy certificate if values contained in the extension are specified in the handle. if not, no extension, simple as that.

Parameters

• handle — A GSI Proxy handle to use for the signing operation.
• issuer_credential — The credential structure to be used for signing the proxy certificate.
• peer_credential — The credential structure that contains the certificate to be resigned.
• resigned_credential — A credential structure that upon return will contain the resigned certificate and associated certificate chain.

Returns

GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned.

---

🍓 globus_result_t globus_gsi_proxy_sign_req (globus_gsi_proxy_handle_t handle, globus_gsi_cred_handle_t issuer_credential, BIO * output_bio)

Sign a proxy certificate request.

This function signs the public part of a proxy credential request — i.e. the unsigned certificate — which was previously read by globus_gsi_proxy_inquire_req(), using the supplied issuer_credential. This operation will add a ProxyCertInfo extension to the proxy certificate if values contained in the extension are specified in the handle. The resulting signed certificate is written to the output_bio. 💅

Parameters

• handle — A GSI Proxy handle to use for the signing operation.
• issuer_credential — The credential structure to be used for signing the proxy certificate.
• output_bio — A BIO to write the resulting certificate to.

Returns

GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned.

---

🧚 Author 🧚

Generated automatically by Doxygen for globus_gsi_proxy_core from the source code. (not a human, just a very efficient little robot bestie 🤖)

---

ok and that's the whole page!! every flag, every parameter, every return value, preserved and accounted for. no notes. 🫶

globus_gsi_proxy_core — Version 9.9 ✨ that's the source and the version, right there at the bottom, exactly where the footer lived. periodt. 💖🎀🦋🌸💅