Affinidi Iota Framework Configuration

To enable the framework:

• Create a configuration.
• Select the wallet for signing the request token.
• Set the token expiry.
• Define the Presentation Definition to query data from Affinidi Vault.

Configuration details

Below are the relevant fields when managing Affinidi Iota Framework Configuration:

Required fields

• Name of configuration: Assigns a name for easy reference.

• Signing Wallet: Select an existing wallet or create a new one. The wallet signs the request token for initiating data requests from Affinidi Vault.

  When creating a new wallet::

  • Name of Wallet: (Required) Provides name for the new wallet.

  • Description: (Optional) Provides the explanation of wallet usage.

  • DID method of wallet: (Default) By default the new wallet will have the DID method did:key.

  Read more about Wallets here.

• Data sharing flow mode: Choose how consent-driven data sharing works in your app. More about this mode here.

• Redirect URLs: If using Redirect mode, list allowed URLs for user redirection and response handling.

• Lifetime of Request Token: Define how long the token remains valid for security.

Optional fields

• Description: Explains the configuration’s purpose.

• Display name: Name shown in Affinidi Vault during consent request.

• Origin: Domain displayed during consent request.

• Logo URL: Your app’s logo shown during consent request.

Recommended fields

• Enable Credential Verification: Verifies credentials shared by the user.

• Enable Consent Audit Log: Stores user consent whenever data is shared.

Identity Verification flow

• Enable Identity Verification (IDV): Enable Identity Verification (IDV) to request a verified identity VC when it’s not available in the user’s Vault.

This triggers a process where the user provides:

• A self-photo
• A supported identity document

Requirements:

• Data sharing flow must use Redirect mode.
• Create a Presentation Definition to query the verified identity VC.

Create configuration

To create a configuration in Affinidi Portal:

1. Go to Affinidi Portal and click on the Affinidi Iota Framework page.
2. Click Create Configuration and set required fields:

3. Add the signing wallet and any additional options.
4. Click Create to complete setup.

After creating your configuration, define Presentation Definitions to query specific data from the Affinidi Vault (a secure data storage service). This uses the Presentation Exchange protocol.

1. Provide a name for the Presentation Definition.
2. Choose a template to pre-populate the editor.
3. Modify the template to match the data you want to request from the Affinidi Vault.

To add more definitions:

• Click + Add to create additional Presentation Definitions.
• Once done, click Create.

Each Presentation Definition generates a Query ID. Use this ID to retrieve the definition and generate a request token to access data from the Affinidi Vault.

Test your configuration

After creating the configuration and Presentation Definitions you can test your queries:

• Click Test on the overview page.
• Select a query and click Send Request.

This initiates a data-sharing request to Affinidi Vault and returns a sample response.

Testing helps optimise queries and ensures correct data parsing before integration.

What’s Next