Server SDK Quickstart

1
const { relayToken, relaySecret, relaySessionAccessToken } =
2
  await persona.relays.create({
3
    claimType: "age_over18_united_kingdom",
4
    encryptionKeyPem: "<your_public_key_pem>", // pass null to opt out of encryption
5
  });
6
7
// Return the Relay session access token to the client
8
return { accessToken: relaySessionAccessToken };

1
const { privacyPassToken } = await persona.relays.issuePrivacyPass({
2
  claimType: "age_over18_united_kingdom",
3
});

1
// Redeem the Privacy Pass and retrieve the claim result
2
const { claimPayload, tokenConsumed } = await persona.relays.generateClaim({
3
  relayToken,
4
  relaySecret,
5
  privacyPassToken,
6
});

1
const claim = JSON.parse(claimPayload);
2
3
console.log(claim.claim_type);   // e.g. 'age_over_18_united_kingdom'
4
console.log(claim.claim_result); // 'passed' or 'failed'
5
console.log(claim.methodology);  // array of MethodologyCalculation, if not hidden

1
import crypto from "crypto";
2
3
const decrypted = crypto.privateDecrypt(
4
  {
5
    key: "<your_private_key_pem>",
6
    padding: crypto.constants.RSA_PKCS1_OAEP_PADDING,
7
  },
8
  Buffer.from(claimPayload, "base64"),
9
);
10
11
const claim = JSON.parse(decrypted.toString("utf8"));
12
13
console.log(claim.claim_type);   // e.g. 'age_over_18_united_kingdom'
14
console.log(claim.claim_result); // 'passed' or 'failed'

1
import Persona from '@persona/sdk-node';
2
import crypto from 'crypto';
3
4
const persona = new Persona({ apiKey: '<your_api_key>' });
5
6
// Step 1: Create a session and return the Relay session access token to the client
7
const { relayToken, relaySecret, relaySessionAccessToken } = await persona.relays.create({
8
  claimType: 'age_over18_united_kingdom',
9
  encryptionKeyPem: '<your_public_key_pem>',
10
});
11
return { accessToken: relaySessionAccessToken };
12
13
// Step 2 — Issue a Privacy Pass (any time before redemption; depends only on the claim type)
14
const { privacyPassToken } = await persona.relays.issuePrivacyPass({
15
  claimType: 'age_over18_united_kingdom',
16
});
17
18
// Steps 1–2 above are server-to-server.
19
// After your client-side integration indicates verification is complete, redeem from your server.
20
21
// Step 3 — Redeem the Privacy Pass and retrieve the claim result
22
const { claimPayload, tokenConsumed } = await persona.relays.generateClaim({
23
  relayToken,
24
  relaySecret,
25
  privacyPassToken,
26
});
27
28
// Step 4 — Decrypt and parse the claim payload
29
const decrypted = crypto.privateDecrypt(
30
  {
31
    key: '<your_private_key_pem>',
32
    padding: crypto.constants.RSA_PKCS1_OAEP_PADDING,
33
  },
34
  Buffer.from(claimPayload, 'base64')
35
);
36
37
const claim = JSON.parse(decrypted.toString('utf8'));
38
39
console.log(claim.claim_type);   // e.g. 'age_over_18_united_kingdom'
40
console.log(claim.claim_result); // 'passed' or 'failed'