#credentials #netrc #cargo-registry #template-engine #cargo-credential

app cargo-credential-netrc

Cargo credential provider that parses your .netrc file to get credentials

1 unstable release

0.1.0 Oct 7, 2024

#126 in Authentication

Download history 173/week @ 2024-10-05 34/week @ 2024-10-12 2/week @ 2024-10-19 12/week @ 2024-11-02

59 downloads per month

MIT/Apache

9KB
64 lines

cargo-credential-netrc

Cargo credential provider that parses your .netrc file to get credentials.

While this may not be the most secure or sophisticated way to manage your credentials, you may already be using .netrc files to handle your authentication for other tools. For such cases, this credential provider can be a useful drop in solution for authenticating with private cargo registries.

Usage

Different private cargo registry providers expect different things in the token. As a result, there is no way to generate the token from the .netrc file that will work for all cases. To address this, this credential provider REQUIRES you to specify the format of the token using the handlebars templating language with the --format argument.

The following variables are available:

  • login
  • account
  • password

NOTE: If your token format requires a space, you MUST use a credential alias to specify the token format.

Example

Here is an example of how to format a token for JFrog's Artifactory:

[credential-alias]
cargo-credential-artifactory = ["cargo-credential-netrc", "--format", "Bearer {{password}}"]

[registries.artifactory]
index = "sparse+<YOUR_ARTIFACTORY_URL>"
credential-provider = "cargo-credential-artifactory"

Dependencies

~7–16MB
~201K SLoC