1# Google Auth Library for Go
 2
 3[![Go Reference](https://pkg.go.dev/badge/cloud.google.com/go/auth.svg)](https://pkg.go.dev/cloud.google.com/go/auth)
 4
 5## Install
 6
 7``` bash
 8go get cloud.google.com/go/auth@latest
 9```
10
11## Usage
12
13The most common way this library is used is transitively, by default, from any
14of our Go client libraries.
15
16### Notable use-cases
17
18- To create a credential directly please see examples in the
19  [credentials](https://pkg.go.dev/cloud.google.com/go/auth/credentials)
20  package.
21- To create a authenticated HTTP client please see examples in the
22  [httptransport](https://pkg.go.dev/cloud.google.com/go/auth/httptransport)
23  package.
24- To create a authenticated gRPC connection please see examples in the
25  [grpctransport](https://pkg.go.dev/cloud.google.com/go/auth/grpctransport)
26  package.
27- To create an ID token please see examples in the
28  [idtoken](https://pkg.go.dev/cloud.google.com/go/auth/credentials/idtoken)
29  package.
30
31## Contributing
32
33Contributions are welcome. Please, see the
34[CONTRIBUTING](https://github.com/GoogleCloudPlatform/google-cloud-go/blob/main/CONTRIBUTING.md)
35document for details.
36
37Please note that this project is released with a Contributor Code of Conduct.
38By participating in this project you agree to abide by its terms.
39See [Contributor Code of Conduct](https://github.com/GoogleCloudPlatform/google-cloud-go/blob/main/CONTRIBUTING.md#contributor-code-of-conduct)
40for more information.