Htpasswd authorization

Authorizes a requesting user via credentials stored in htpasswd format.

Properties

type

Authorization Type = "htpasswd"

Has to be set to htpasswd to enable the htpasswd authorization.

file

File Path = "<os specific>"

A file where each line contains an entry in htpasswd format.

The default value varies depending on the platform Bifröst runs on:

• Linux: /etc/engity/bifroest/htpasswd
• Window: C:\ProgramData\Engity\Bifroest\htpasswd

Examples

foo:$apr1$zapgfl56$eXIHR/wBYFypkUEXWdCZN/
bar:$apr1$wqkvo7c2$dqi5g.hK67jLMY4SJzrjq.

entries

string

This is similar to file, but does contain the htpasswd entries directly inside the configuration.

Examples

authorization:
  type: htpasswd
  entries: |
    foo:$apr1$zapgfl56$eXIHR/wBYFypkUEXWdCZN/
    bar:$apr1$wqkvo7c2$dqi5g.hK67jLMY4SJzrjq.

Format

htpasswd is a format created for Apache HTTP Server to enable an easy way to configure Basic Authentication for web servers. Nowadays it is used in more web server projects than just the Apache HTTP Server and also in other project type like Bifröst. The reason: There is a huge toolset available to create those files.

Tools

1. Apache HTTP Server command line tool which can be easily installed on many systems such as:
   • Ubuntu:

     sudo apt-get install apache2-utils -y
     

   • Fedora/RedHat:

     sudo apt install apache2-utils -y
     

2. Helm for Kubernetes function
3. Ansible module
4. Terraform/OpenTofu plugin
5. ...

Context

This authorization will produce a context of type Authorization Htpasswd.

Examples

1. Using dedicated file from default location:

   type: htpasswd
   

2. Using dedicated file from custom location:

   type: htpasswd
   file: /etc/foo/bar
   

3. Using embedded entries:

   type: htpasswd
   entries: |
     foo:$apr1$zapgfl56$eXIHR/wBYFypkUEXWdCZN/
     bar:$apr1$wqkvo7c2$dqi5g.hK67jLMY4SJzrjq.
   

Compatibility

linux/generic	linux/extended	windows/generic
*	*	*