Gafaelfawr#

Gafaelfawr provides the authentication and authorization infrastructure for Phalanx environments, including the Vera C. Rubin Observatory Science Platform.

Its primary purpose is to serve as an NGINX auth_request backend. It also provides a web page where people can create and manage long-lived tokens for use outside of a web browser, and can serve as a simple OpenID Connect server. Gafaelfawr requires the Kubernetes NGINX ingress controller.

Gafaelfawr is developed on GitHub.

Gafaelfawr is part of the Rubin Science Platform identity management system. Its design is documented in DMTN-234, and its implementation in DMTN-224. History and decisions made during its development are documented in SQR-069. Read those documents for a more complete picture of how Gafaelfawr fits into a larger identity management system.

User Guide

Learn how to protect services with Gafaelfawr and use the Gafaelfawr client.

User guide
API

See the full API documentation for the Gafaelfawr client.

Gafaelfawr APIs
Operations

Learn how to configure and administer the Gafaelfawr server.

Operations guide
Development

Learn how to contribute to the Gafaelfawr codebase.

Developer guide

Gafaelfawr is named for Glewlwyd Gafaelfawr, the knight who challenges King Arthur in Pa gur yv y porthaur? and, in later stories, is a member of his court and acts as gatekeeper. Gafaelfawr is pronounced (very roughly) gah-VILE-vahwr. (If you speak Welsh and can provide a better pronunciation guide, please open an issue!)