guides:credential_access [UBNetDef]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
<alert type="danger">This is not being used! Ignore everything on here!</alert>

====== Credential Access ======

  - Using a web browser, access [Athena](https://athena.ubnetdef.org)
  - You should see a page similar to the one below.  Please enter the **SHARED PASSWORD** in this screen.  This is to decrypt the Password Vault.
    - {{:guides:vault_pw_screen.png?400|}}
  - When you press enter, you will be asked for a username/password.  Please enter your **PERSONAL USERNAME/PASSWORD**.  This is to access WebDAV.
    - {{:guides:vault_login_screen.png?400|}}
  - You're in! Please ensure you **save** after any changes.  To save, click on "UBNetDef - Main" on the bottom right.  Then go to the sidebar item called "UBNetDef - Main".  Press **save** and ensure the "Last Sync" area updates to the current time.
    - {{:guides:vault_save.png?400|}}

===== About Athena =====

Most credentials are located on our credential server - [Athena](https://athena.ubnetdef.org).  Athena runs an instance of [KeeWeb](https://github.com/keeweb/keeweb), with WebDAV setup to store/upload credential files.

Gaining access to Athena is a two part process.
  - You must be told the KeePass Database Password
  - You must be given credentials to read/upload to the WebDAV File Store

To get access to Athena, please contact [Kevin](/user/kpcleary) or [James](/user/jamesdro).

===== Internal: Granting Access =====
  - SSH into `ubnetdef.org`
  - Run `sudo htpasswd /web/athena.ubnetdef.org/htpasswd USERNAME`
    - USERNAME is the user you wish to give access to
    - Have the user enter the password. As a note, they cannot change it (as only root has access to write this file)
  - Give them the KeePass DB password. You _do_ remember it, don't you?

===== Internal: Updating KeeWeb =====
  - SSH into `ubnetdef.org`
  - Change to the user `web-builder`
  - Go to `/web/athena.ubnetdef.org/public`
  - Run `git pull origin gh-pages`
  - You're done! Make sure the `settings.json` file still exists