ci-id 0.2.0

Ambient OIDC credentials detection on CI systems
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

## Ambient credentials detection for CI systems

[![CI badge](https://github.com/jku/ci-id/actions/workflows/ci.yml/badge.svg)](https://github.com/jku/ci-id/actions/workflows/ci.yml)

`ci-id` provides easy access to ambient OIDC credentials in CI systems.

```rust
use ci_id::{detect_credentials, CIIDError};

fn main() -> Result<(), CIIDError>  {
    let token = detect_credentials(Some("myaudience"))?;
    print!("Ambient OIDC token detected: {}", token);
    Ok(())
}
```

See [ci-id-bin](https://crates.io/crates/ci-id-bin) crate for a simple CLI wrapper.

ci-id is based on [id](https://github.com/di/id), a similar Python project.

### Supported environments

Currently supported environments are:
* GitHub Actions
* GitLab CI/CD
* CircleCI
* Buildkite

See [documentation](https://docs.rs/ci-id/latest/ci_id/) for details on what configuration each of these environments needs.

### License

`ci-id` is licensed under the Apache 2.0 License.