This document walks you through the functionalities of the CARO app, Spherity's Credentialing Service for Authorized Trading Partners (ATP), to enable you to navigate the user interface. It does neither explain any technical details of the Credentialing Service nor provide guidelines for the technical implementation of CARO.
If you are looking for a high-level overview of CARO, visit our website. You may also want to peruse some Essential Concepts about our app.
All our documents are updated continuously. Please check back frequently, as new features and functionalities will be added to our applications and explained here.
You must be invited to CARO before you can access the app's dedicated Service Provider space. The web app resides on app.caro.vc.
Once you have received an email invite, accept it by following the link in the email. On the CARO log-in screen you can check your details and set a password. After log-in, you will be forwarded to the CARO Dashboard.
The search function applies across the CARO app. It groups results into applicable categories, such as reports, events, or credentials. You can access it by clicking on the magnifying glass icon 🔎 in the top right corner of the app screen or by using the keyboard shortcut CTRL+K.
Clicking on the cogwheel icon ⚙️ in the top right corner of the app screen opens the global application settings. Here you can manage the security settings that apply across the entire Enterprise Account. You can check which service providers are integrated with your Enterprise Account. You can also find helpful links.
You can find your profile in the menu section Enterprise Wallet. Edit your profile as you want it to appear in the :spherity_icon_gradient: CARO network.
You can find your Enterprise Identifiers in the menu section Enterprise Wallet. This screen shows your Enterprise Account's decentralized identifiers (DIDs). By clicking on the square-shaped :qr-code: icon right beside each DID, you can reveal its QR code. Scan it with a mobile device camera to insert your DID into other trusted applications to connect them to CARO.
<aside> ❗
Generally, we advise to keep your DID strictly confidential. Never publish it. Do not share it by email. Treat it like a sensitive password. Always be sure that you trust the party with whom you are sharing your DID!
</aside>
<aside> ℹ️
Each Enterprise Account must have at least one Enterprise Identifier because having a unique DID assigned to your enterprise is a prerequisite for credential acquisition.
Each enterprise that requires its own set of credentials must have its own DID. This DID is persistent. This means it will never change within the system so that it continuously identifies the particular enterprise to which it had been assigned originally.
</aside>
🔖 Read more at What are identifiers & credentials in CARO?
Generally, CARO automatically creates your first DID as part of the initial onboarding process.
Should you require more DIDs, say for additional business locations that hold their own credentials, you will need to create a new unique DID per additional organization.
<aside> ❗
It is important to note that any VRS events linked to any of the DIDs in the same Enterprise Account will be visible to all users with the respective user-level permissions within this Enterprise Account. If you wanted to keep the interaction records of particular enterprises separate, you would need to create a new separate Enterprise Account instead. Please contact us to explore which option is most suitable for your situation if you are unsure.
</aside>
After clicking New Identifier on the main screen, you will be prompted to give your new DID a meaningful name and select a method to create this identifier, a so-called DID method.
If all you want is to create a DID for a real organization, simply select one of the first two options (did:ethr with/without HSM). HSM means 'Hardware Security Module'. CARO uses a cloud-based version, which provides enhanced security by preventing extraction of your private keys. You can have no more than 1 HSM-backed DID in your CARO Enterprise Account.
If you are interested in experimenting with CARO, select any of the DID methods in tab Testing Identifiers. Please contact us if you want us to join your experiment or to discuss your needs.
Once you have confirmed your choice, you will see your newly created DID listed.
This screen shows a list of all customers who have granted you access to their account.
Clicking on any of the customers in the list will open a details view of this customer. Besides some basic information, it includes a list of their Enterprise Identifiers.
This screen shows a list of all Verifiable Credentials you have issued from this CARO account.
Clicking on any of the credentials in the list will open a details view of this credential.
