Guide: how to install a machine credential

Guide overview:

Who should use this guide

Before you start

Installing a machine credential

Installing a browser extension

Who should use this guide

Principal Authority

A Principal Authority is a business owner or an eligible associate of an entity listed in the Australian Business Register (ABR). 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

A representative with a Machine Credential Administrator role can create machine credentials on behalf of the entity. A Machine Credential Administrator will only be required if your entity uses software to interact directly with government online services.

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

Before you start

In order to install a machine credential from RAM you must be either a Principal Authority or a Machine Credential Administrator (MCA) for the entity.

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

  1. Using Chrome or Firefox, go to authorisationmanager.gov.au Select the myGovID login button.

 

  1. 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.

  1. Click Manage authorisations to be redirected to view all the entities you can act for

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

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

Note: This tab only appears if you are a Principal Authority or Machine Credential Administrator.

  1. The Manage credentials page is displayed.

    If you’ve already installed the required browser extension, skip this step.

    If this is the first time installing a machine credential, you will see a message advising that browser extension software is required. Refer to Installing a browser extension

    Click the link to visit Machine credential downloads.

    Click the browser extension link for your operating system.

    Install and enable the browser extension.

    Close down your browser.

 

 

  1. Reopen your browser and go to https://authorisationmanager.gov.au and login with your myGovID and navigate back to the Manage credentials page.

 

  1. The Create machine credential page is displayed. Select Create machine credential and 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 – Enter a password.

    Credential name – Enter a name for the machine credential.

    Identify the Machine Credential Custodian – This will be pre-filled with your name and cannot be changed.

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

 

  1. The Credential Installed notification is displayed upon successful installation. Click Finish to return to the Manage credentials page.

 

  1. The Manage credentials page allows you to create, view, and revoke machine credentials for the entity.

Installing a browser extension

In order to create a machine credential you will need to download and install a browser enabler/extension compatible with your device’s operating system.

Windows

MAC OS

Linux

Download and install a browser extension for Windows

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

  1. The ATOBE Installer will open. Click ‘I Agree’ to progress.

 

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

 

  1. Click ‘Close’ to finalise installation.

 

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

    Click ‘OK’. Restart any open browsers or logoff
    and on again.

Download and install a browser extension for MAC OS

Use the link:https://info.authorisationmanager.gov.au/sites/default/files/atobeinstal... and save the file. Go to your Downloads folder and run ‘ATOBEInstaller.pkg’.

 

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

 

  1. The ATOBE Installer will open. Click ‘Continue’.

 

  1. The ‘License’ information will be displayed. Click ‘Continue’ then
    ‘Agree’ to progress.

 

  1. 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’.

 

  1. To finalise installation all applications must be closed and you will be logged out when complete. Click ‘Continue Installation’.

 

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

 

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

 

  1. 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

Use link: https://info.authorisationmanager.gov.au/sites/default/files/atobeinstaller_nix_sh.zipExternal Link and click on ‘ATOBEInstaller-nix.sh’.

 

  1. Ensure that all browser sessions are closed.

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

 

  1. The following console output will appear (elided below with comments).


  2.  
  3.  

 

 

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

 

 

  1. 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.