- Account: your partner settings and allowed domains.
- Issuer: schemas, issuance programs, and issuance records.
- Verifier: verification programs, verification records, and the fee wallet.
Account
General Settings
Domains
AIR Kit only loads on domains you allow. You can add up to 3 domains or subdomains, and wildcards such as*.myapp.example.com are supported. Some domains are blocked for security reasons; contact the AIR team if you need one of them.
In sandbox,
localhost is allowed on ports 3000, 5173, and 8200, and you cannot add it to the list yourself. Production requires HTTPS domains.Issuer
The Issuer section is for partners that issue credentials. It has three areas: the schema builder, issuance programs, and issuance monitoring.1. Schema Builder
This is the starting point for creating any new credential. A Schema acts as a blueprint, defining the structure, data type, and rules for a specific type of credential.- Create Schemas: Issuers can build custom schemas by defining a title, version, and description.
- Define Attributes: Within each schema, issuers add specific data fields (attributes). For each attribute, they define a name, data type (e.g., string, number, boolean), a descriptive title, and can mark it as required.
- Publish: Publish the schema to use it in issuance programs. See Schema creation for field types and design rules.
2. Issuance Program
An issuance program defines a credential your issuer service can issue, based on a published schema.- Select a Schema: The process begins by selecting the appropriate schema, which loads its predefined attributes.
- Set Issuance Rules: Issuers can configure key parameters for the credential, such as:
- Accessible Until: An optional date range during which the credential is valid.
- Maximum Issuance: An optional cap on the total number of credentials that can be claimed.
- Expiration Duration: The lifespan of the credential after it has been issued to a user (e.g., 90 days, 1 year, permanent).
- Use the program ID: Pass the program ID to
issueCredentialin your app. Your issuer service signs and issues the credential when the user claims it.
3. Issuer Dashboard Monitoring
This section provides a high-level overview and detailed logs of all issuance activity.- Key Metrics: View statistics like the Total Issued Number (the total number of credentials claimed by users) and the Total Credential Number (the number of different credential types created).
- Claim Records: See a detailed list of every credential that has been claimed by a user, including the Holder ID, Credential ID, and the Claimed Time. Issuers can also revoke a claimed credential directly from this interface.
Verifier
The Verifier section is for partners that check users’ credentials. It is centered on verification programs.1. Verification Program Management
A verification program defines which credentials you accept and which claims you request.- Choose the credential: Select the schema, the issuers you trust, and the accepted proof type (
SD_JWT_VCby default). - Request claims: Choose which claims the user is asked to disclose. The user sees them on the consent screen and shares only those. See Selective disclosure.
- Use the program ID: Pass the program ID to
verifyCredentialin your app.
2. Verifier Dashboard Monitoring
This dashboard provides a comprehensive record of all verification activities.- Key Metrics: View the Total Verified Number of credentials and other relevant statistics.
- Verification Records: Access a detailed log of all verification attempts, including the Holder ID, the Program Name used, the Verified Time, and the Current Status (e.g., Passed, Verification Failed).