SAML Integrator

  • Canonical IS DevOps
Channel Revision Published Runs on
latest/stable 66 20 Sep 2024
Ubuntu 22.04
latest/edge 69 19 Nov 2024
Ubuntu 22.04 Ubuntu 20.04
latest/edge 6 01 Aug 2023
Ubuntu 22.04 Ubuntu 20.04
juju deploy saml-integrator
Show information

Platform:

Ubuntu
22.04 20.04

Charm architecture

The SAML Integrator charm fetches SAML metadata details based on the provided configuration and propagates them through a Juju integration.

Juju events

According to the Juju SDK: “an event is a data structure that encapsulates part of the execution context of a charm”.

For this charm, the following events are observed:

  1. upgrade-charm: fired on the charms when the unit is undergoing an upgrade. Action: install charm dependencies.
  2. config-changed: usually fired in response to a configuration change using the GUI or CLI. Action: validate the configuration and fetch the SAML details from the metadata URL. If there are relations, update the SAML details in the relation databag.
  3. saml-relation-joined: Custom event for when a new SAML relations joins. Action: write the SAML details in the relation databag.

Charm code overview

The src/charm.py is the default entry point for a charm and has the SamlIntegratorOperatorCharm Python class which inherits from CharmBase.

CharmBase is the base class from which all Charms are formed, defined by Ops (Python framework for developing charms).

See more information in Charm.

The __init__ method guarantees that the charm observes all events relevant to its operation and handles them.


Help improve this document in the forum (guidelines). Last updated 1 year, 3 months ago.