Guide: how to install a machine credential

Guide overview:

Before you start

Before you create a machine credential, you need to download and install a browser extension compatible with your device’s operating system. These extensions are for Firefox and Chrome-based web browsers on the following operating systems:

For detailed instructions see the Installing a browser extension section.

How to install a machine credential

Step 1

Using Chrome or Firefox, go to info.authorisationmanager.gov.au and then click the Login with myGovID button or the Login button in the top right-hand corner.

Step 2

Enter the email address that you used to set up your myGovID.

A code will appear in your browser. Open the myGovID app on your smart device, enter the 4-digit code and click Accept. If you have selected the ‘Remember me’ option, you will only need to click Accept in your app.

Step 3

Click View or manage authorisations, machine credentials and cloud software notifications. You will be directed to a view of all the entities you can act for.

Select the entity you would like to create a machine credential for.

Screen showing an example of where you can select the entities you can act on behalf of.

Step 4

The entity homepage will be displayed with a list of all the authorisations for the entity. Click the Manage Credentials tab in the toolbar.

Screen showing a list of all authorisations for the entity.

Step 5

The Manage credentials page is displayed.

Screen showing the notification that software is required.

 

If you’ve already installed the required browser extension, go to the next step.

If you have not yet installed the required browser extension, you'll receive a message that browser extension software is required.

Click Machine credential downloads or see the Installing a browser extension section.

Select, install and enable the browser extension link for your operating system.

Close your browser, then reopen it and follow Steps 1-6.

Step 6

Select Create machine credential.

Screen of Create a machine credential page with create a machine credential button in the top right hand corner.

Step 7

Enter the following information:

  • Keystore path – this is where the machine credential will be created and stored, the information will be pre-filled but can be changed if required.
  • Keystore password – choose a password that is at least 10 characters (with no space) including an upper case letter, a lower case letter, a number and a special character. You’ll provide this password within your software either when setting up or authenticating. You should not use your myGovID password for the ‘Keystore password’.
  • Verify your keystore password – re-enter your chosen password.
  • Credential name – create a name for your machine credential that will help you to easily identify the machine credential.
  • Identify the machine credential custodian – this will be pre-filled with your name and cannot be changed.

When creating a machine credential, you can store it in:

  • an existing keystore by using the initial keystore path and password    
  • a new keystore by changing the keystore path and password
  • a new keystore each time you create one - you will need to change the keystore path each time you create a new machine credential to do this.

The machine credential keystore is generated in Extensible Markup Language (XML). If your software requires the keystore to be stored in an alternative format, you’ll need to follow the guidance provided by your digital service provider to convert and install the keystore.

Tick the box to confirm you understand and accept the machine credential details.

Click Download.

Screen showing fields for the Keystore path, Keystore password and Credential name.

Step 8

Once downloaded you will receive a message confirming that the machine credential has been installed.

Screen showing the message that a machine credential has been installed successfully.

Step 9

From the Manage credentials page you can create, edit, revoke and claim unassigned machine credentials for the entity.

Screen showing the newly created machine credential listed on the Create a machine credential page.

Installing a browser extension

To create a machine credential, you will need to download and install a browser enabler/extension that is compatible with one of the following operating systems:

Download and install a browser extension for Windows

Step 1

Use the link: info.authorisationmanager.gov.au/sites/default/files/atobeinstaller_exe.zip (ZIP 2.8MB) and save the file. Go to your Downloads folder and run ‘ATOBEInstaller.exe’.

Step 2

The ATOBE Installer will open. Click I Agree to progress.

If the following message appears, close any open browsers and click Retry.

Step 3

Click Close to finalise installation.

Step 4

You have now successfully installed the browser extension onto your computer.

Click OK. Restart any open browsers or log off and log on again.

Download and install a browser extension for MAC OS

Step 1

Use the link: authorisationmanager.govcms.gov.au/sites/default/files/atobe_installer_pkg.zip (ZIP 1.2MB) and save the file. Go to your Downloads folder and run ‘ATOBEInstaller.pkg’.

Step 2

The ATOBE Installer will be made available in the ‘Downloads’ folder. Click on Download to activate.

Step 3

The ATOBE Installer will open. Click Continue.

Step 4

The license information will be displayed. Click Continue then Agree to progress.

Step 5

The destination is automatically selected. Click Install and enter your computer password to allow installation. Then click Install Software.

Note: You can change the install location if required before clicking Install.

Step 6

To finalise installation all applications must be closed. Click Continue Installation. You will be logged out when complete.

Step 7

You have now successfully installed the browser extension onto your computer.

Step 8

You can move the ATOBE Installer to the trash as required and delete.

Step 9

Once the ATOBE has been added you will need to select Enable Extension for it to work.

Screenshot showing the Enable extension button.

Download and install a browser extension for Linux

Step 1

Use link: https://info.authorisationmanager.gov.au/sites/default/files/atobeinstaller_nix_sh.zip (ZIP 146KB) and click on ‘ATOBEInstaller-nix.sh’. Ensure that all browser sessions are closed.

Step 2

Open a terminal window at the download location and run ‘Bash ./ATOBEInstaller-nix.sh’.

Step 3

The console output will appear.


Step 4 – libjansson_library.png

The installer checks to see that the dependent library libjansson is present. If it is not, please install it from the relevant repository.

Step 5

The installed executable is run. Errors will be produced if there are any other dependent libraries missing. Check and install any other missing dependencies.

You have now successfully installed the browser extension onto your computer.