Viz Engine Administrator Guide

Version 4.2 | Published December 04, 2020 ©

Authentication

The Authentication panel is for the authentication of one or more Viz One systems on Viz Artist. Enter the details of each Viz One system to connect to. To save a new user, all three panels of the Authentication panel must be completed. If a Realm is not required, enter <empty> in the Realm panel. If only one or two panels are completed, the information is not saved.

images/download/attachments/54011385/cfg_v1_auth.png

  • Host Info: The host name of the Viz One server.

  • Realm: Determines if an entry should be used in an authentication process for a given URI.

  • User Info: Name and password for each User, for the selected Host and Realm.

Authentication Properties

Host Info Properties

The host name of the Viz One server (see also Fsmon (File System Monitor)). The host info is in the form ‘host:port’, where the colon and port number are optional. An asterisk value, '*', shows that it is used against all hosts. The host info can be the Viz One host name or IP address.

Examples:

  • Host Info = myhost.mycompany.com:8080

  • Host Info = 10.0.1.2:8080

  • Host Info = *

  • A Host cannot be added without at least one Realm (or an empty Realm with <empty> entered) and one User defined.

  • A Host can have more than one Realm.

    images/download/attachments/54011385/cfg_v1_ahost.png
  • Add: Adds a host name.

  • Change: Changes a selected host name.

  • Remove: Removes a selected host name.

  • Host Info: Displays the name of the required Viz One host.

    Note: Do not enter a URL as the Host Info name. The Host Info name format must be host[:port], for example: vizone.mycompany.com:8080.

    images/download/attachments/54011385/cfg_v1_warn.png

Realm Properties

Determines if an entry should be used in an authentication process for a given URI.

Example: A single value of shows that it should be used against all realms (i.e. Realm = [a-zA-Z_0-9] or ‘ * ’).

  • A Realm cannot be added to a Host without at least one User defined

  • A Realm can have more than one User.

    images/download/attachments/54011385/cfg_v1_arealm.png
  • Add: Adds a Realm.

  • Change: Changes a selected Realm.

  • Remove: Removes a selected Realm.

  • Realm: Displays the name of the required Realm.

User Info Properties

Name and password for each user, for the selected Host and Realm. Passwords are not mandatory.

images/download/attachments/54011385/cfg_v1_auser.png

  • Add: Adds a user.

  • Change: Changes a selected user.

  • Remove: Removes a selected user.

  • User: Enter the user name.

  • Password: Enter a password for the user, if required.

  • Confirm PW: Confirm the user password.

Authentication Panel Procedures

Do not enter a URL as the Host Info name. The Host Info name format must be host[:port]. For example: www.mycompany.com:8080. Only entries which consist of Host + Realm + User are saved to the configuration file. After the completion of the required procedures, make sure that you restart Viz Artist. Changes are not saved until Viz Artist has been restarted.

To Add a Viz One Host

To add a Viz One Host, a Realm and a User must also be defined.

  1. Enter a Viz One Host name.

  2. Click Add.

    images/download/attachments/54011385/cfg_v1_host.png
  3. Enter a Realm name. If no Realm is required, enter <empty>.

  4. Click Add.

    images/download/attachments/54011385/cfg_v1_realm.png
  5. Enter the new User name.

  6. Enter and confirm the password, as required.

  7. Click Add.

    images/download/attachments/54011385/cfg_v1_user.png
  8. Click Save or Save as...

    images/download/attachments/54011385/cfg_v1_1user.png

To Add a Realm

  1. Click on a Viz One Host.

  2. Enter a Realm name.

  3. Click Add.

    images/download/attachments/54011385/cfg_v1_realm2.png
  4. Enter a User name.

  5. Enter and confirm the password, if required.

  6. Click Add.

    images/download/attachments/54011385/cfg_v1_u2.png
  7. Click Save or Save as...

    images/download/attachments/54011385/cfg_v1_1u2.png

To Add a User

  1. Select a Viz One Host.

  2. Select a Realm.

  3. Enter a User name.

  4. Enter and confirm a User password, if required.

  5. Click Add.

  6. Click Save or Save as...

    Note: The password of the currently highlighted User always shows in the Password box.

To Change a Host, Realm or User Name

  1. Click in the name field for either the:

    • Host Info

    • Realm

    • User

  2. Make a change to the name as required.

  3. Click Change.

  4. Click Save or Save as...

To Delete a Host, Realm or User Name

If a Host is removed, any defined Realms or Users for that Host are also removed. If a Realm is removed, all Users for that Realm are also removed. When the last User is deleted then the related realm is deleted as well.

  1. Make sure that the item to be deleted is highlighted (1).

  2. Click Remove (2) for either the:

    • Host Info

    • Realm

    • User

  3. Click Change.

  4. Click Save or Save as...

    images/download/attachments/54011385/cfg_v1_adel.png

See Also