Guide: how to install a machine credential

Guide overview:

Who should use this guide

To create a machine credential in RAM, you must be either a principal authority or a machine credential administrator (MCA).

Principal Authority

A principal authority is a person responsible for a business, either:

  • a sole trader
  • an eligible associate listed against the Australian business number (ABN) in the Australian Business Register (ABR)
  • a primary person (where no individual associates are listed in the ABR) such as a corporate trustee, authorised contact for a government agency or responsible person for an Australian charity.

The principal authority is responsible for the initial set-up of the entity in RAM. A principal authority can complete all activities in this guide.

Machine credential administrator (as assigned by a principal authority or authorisation administrator)

A representative with an MCA role can create machine credentials on behalf of the entity.

To authorise an MCA, create a new authorisation in RAM and select Yes when asked whether you want the user to be an MCA. To make an existing user an MCA, edit their authorisation in RAM.

Before you start

Before you create a machine credential you will 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:

Detailed instructions on installing the compatible browser extension can be found in the Installing a browser extension section.

How to install a machine credential

Step 1

Using Chrome or Firefox, go to authorisationmanager.gov.au and select the myGovID login button.

Step 2

Log in using your myGovID by entering the email address that you used to create your myGovID.

A code will appear. Open myGovID on your smart device, log in and enter the 4 digit code into the pop-up within the app. Tap Accept.

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.

Step 4

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

Step 5

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

Step 6

The Manage credentials page is displayed.

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

If you have not yet installed the required browser extension, a message advising that browser extension software is required will appear.

Click Machine credential downloads.

Select the browser extension link for your operating system.

Install and enable the browser extension. Refer to the Installing a browser extension section.

Close your browser, then reopen it and go to authorisationmanager.gov.au to log in again with your myGovID. Then go to the Manage credentials page.

Step 7

Select Create machine credential

 

Step 8

Enter the following information:

  • Keystore path – This will be pre-filled but can be changed if required. This is where the machine credential will be created and stored.
  • Keystore password – Choose a password. It should include at least 10 characters with no space, an upper case letter, a lower case letter, a number and a punctuation character. You’ll provide this password within your software either when setting up or authenticating. You are not required to use your myGovID password for the ‘Keystore password’
  • Verify your keystore password.  
  • Credential name – Enter a name for the machine credential. You should create a name which 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 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.

Step 9

Step 10

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

Installing a browser extension

To create a machine credential, you will need to download and install a browser enabler/extension that is compatible with your device’s operating system. Choose from the following:

Download and install a browser extension for Windows

Step 1

Use the link: info.authorisationmanager.gov.au/sites/default/files/atobeinstaller_exe.zip 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: info.authorisationmanager.gov.au/sites/default/files/atobeinstaller_pkg.zip 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 you will be prompted to 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 be prompted to Enable Extension in order for the browser enabler to work.

Download and install a browser extension for Linux

Step 1

Use link: https://info.authorisationmanager.gov.au/sites/default/files/atobeinstaller_nix_sh.zip 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.