https://github.com/portward/registry-auth

Authentication library implementing the Docker Registry v2 Auth specification
https://github.com/portward/registry-auth

container-registry docker docker-registry docker-registry-authentication docker-registry-v2 hacktoberfest oci-distribution

Last synced: 6 months ago
JSON representation

Authentication library implementing the Docker Registry v2 Auth specification

• Host: GitHub
• URL: https://github.com/portward/registry-auth
• Owner: portward
• License: mit
• Created: 2023-09-19T16:40:38.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2025-01-03T11:15:54.000Z (over 1 year ago)
• Last Synced: 2025-01-03T11:38:02.214Z (over 1 year ago)
• Topics: container-registry, docker, docker-registry, docker-registry-authentication, docker-registry-v2, hacktoberfest, oci-distribution
• Language: Go
• Size: 195 KB
• Stars: 5
• Watchers: 1
• Forks: 0
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Registry auth

[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/portward/registry-auth/ci.yaml?style=flat-square)](https://github.com/portward/registry-auth/actions/workflows/ci.yaml)

[![go.dev reference](https://img.shields.io/badge/go.dev-reference-007d9c?logo=go&logoColor=white&style=flat-square)](https://pkg.go.dev/mod/github.com/portward/registry-auth)

[![built with nix](https://img.shields.io/badge/builtwith-nix-7d81f7?style=flat-square)](https://builtwithnix.org)

**Authentication library implementing the [Docker Registry v2 Auth specification](https://github.com/distribution/distribution/blob/42ce5d4d51cad58f5ec835ce0368344aab860300/docs/spec/auth/index.md).**

> [!WARNING]

> **Project is under development. Backwards compatibility is not guaranteed.**

## Installation

```shell

go get github.com/portward/registry-auth

```

## Usage

This project is a _library_ that you can use to build your own authorization service for a container registry.

To see it in action, check out [https://github.com/portward/portward](https://github.com/portward/portward).

## Development

**For an optimal developer experience, it is recommended to install [Nix](https://nixos.org/download.html) and [direnv](https://direnv.net/docs/installation.html).**

Run tests:

```shell

just test

```

Run linter:

```shell

just lint

```

## License

The project is licensed under the [MIT License](LICENSE).