eBECAS/EDMISS Classic (Desktop)

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.