# Affinidi Iota Framework configuration

> This page explains how to create and configure Affinidi Iota Framework for your website.

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](/products/affinidi-elements/wallets.md).

- 
Data sharing flow mode: Choose how consent-driven data sharing works in your app.
More about this mode [here](/products/affinidi-elements/iota-framework.md#data-sharing-flow-mode).

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

Note

We recommend to enable these options for the additional benefit of [Credential Verification](/products/affinidi-elements/credential-verification.md), which verifies if the data shared is tamper-evident and stores the consent provided by the user when sharing data with your website.

### 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](/products/affinidi-elements/affinidi-vault/identity-verification.md#supported-documents)

Requirements:

- Data sharing flow must use Redirect mode.

- Create a Presentation Definition to query the verified identity VC.

Note

Identity Verification feature is currently in Closed Beta. To enable this feature in your project, send us a request through [Contact Us](https://www.affinidi.com/get-in-touch) form.

## Create configuration

To create a configuration in Affinidi Portal:

- Go to [Affinidi Portal ](https://portal.affinidi.com/iota) and click on the  Affinidi Iota Framework page.

- Click Create Configuration and set required fields:

- Add the signing wallet and any additional options.

- 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](https://identity.foundation/presentation-exchange) protocol.

- Provide a name for the Presentation Definition.

- Choose a template to pre-populate the editor.

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

    Note
    You can only create up to 10 Configurations per Project. If you wish to create more than 10 Configurations, you must create a new Project.

## 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

  [Implement consent-driven data-sharing flow on your website](/products/affinidi-elements/iota-framework/implement-consent-driven-data-sharing.md)

  [View data-sharing consent logs](/products/affinidi-elements/iota-framework/view-consent-logs-app.md)