Skip to main content
Skip table of contents

USI Setup

Step 1: Obtain an M2M Credential

  1. Register for an M2M Credential. Follow the steps provided here to acquire your Machine-to-Machine (M2M) credential: https://softwaredevelopers.ato.gov.au/M2M

  2. Record the following details during registration:

    • Device Name

    • Org Code

    • Password: Associated with the new M2M credential

Step 2: Set Up the Keystore File on a Shared Network

The keystore file must be stored in a network location accessible to all eBECAS users who will be using the USI service. This file is a mandatory requirement of the Government USI service, as the keystore file is used every time a USI validation occurs to verify credentials.

  1. You will receive a file named keystore-new.xml when registering for the M2M credentials.

  2. Rename keystore-new.xml to keystore.xml.

  3. Place the keystore.xml file in a shared network location accessible to all eBECAS users who will be using the USI service.

    • Example of a Shared Path: (Note: This is just an example; actual network setups may vary.)
      \\server\KeystoreLocation\keystore.xml

  4. Ensure all client PCs can access the file from the shared network location via File Explorer.

Step 3: Configure USI in eBECAS

  1. Go to Utilities > Setup Configuration > USI in eBECAS.

  2. Enter the M2M credential details:

    USISetup.png
    • Device Name

    • Org Code

    • Password

  3. Set the Keystore File Path. Point to the shared network location where you stored the keystore.xml file in Step 2: Set Up the Keystore File on a Shared Network.

  4. Click OK to save the configuration.

Final Steps

After saving the settings, notify the eBECAS support team at support@equatorit.com.

The eBECAS team will finalize the configuration to ensure the system is correctly set up to use the new keystore file.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.