Documentation

Everything you need to integrate Grantiva into your iOS app and start validating attestations.

Quick Start Guide

Get your iOS app secured with Grantiva in just a few steps

1

Create Your Account

Sign up for Grantiva with your Apple Team ID and Bundle ID. No API keys needed - authentication is handled automatically.

Get started now
2

Add to Your iOS App

Integrate the Grantiva SDK into your iOS app. Compatible with iOS 14.0+.

// Swift Package Manager
.package(url: "https://github.com/grantiva/ios-sdk", from: "1.0.0")
3

Configure & Validate

Initialize Grantiva and start validating attestations. The SDK automatically handles all configuration.

import Grantiva

// Initialize Grantiva - bundle ID is inferred automatically
let grantiva = Grantiva()
let result = try await grantiva.validateAttestation()

if result.isValid {
    // Device is authenticated and trusted
    let permissions = result.permissions
    let riskScore = result.deviceIntelligence.riskScore
}

API Reference

RESTful API endpoints for server-side integration

GET /api/v1/attestation/challenge

Generate Challenge

Generate a cryptographic challenge for App Attest validation. No API key required.

Required Headers:

X-Bundle-ID: com.example.app
X-Team-ID: ABCD1234XY
{
  "challenge": "base64-encoded-challenge",
  "expiresAt": "2024-01-01T12:00:00Z"
}
POST /api/v1/attestation/validate

Validate Attestation

Validate an App Attest attestation object and receive a JWT token. No API key required.

Required Headers:

X-Bundle-ID: com.example.app
X-Team-ID: ABCD1234XY
{
  "token": "jwt-token",
  "deviceIntelligence": {
    "riskScore": 15,
    "jailbreakDetected": false
  }
}
GET /api/v1/analytics/dashboard

Analytics Dashboard

Get comprehensive analytics about your app's security metrics.

{
  "totalDevices": 1500,
  "riskMetrics": {
    "averageRiskScore": 25,
    "jailbrokenDevices": 3
  }
}
GET /api/v1/analytics/devices/:keyId

Device Details

Get detailed information about a specific device's security profile.

{
  "keyId": "device-key-id",
  "riskScore": 20,
  "attestationCount": 15,
  "complianceStatus": "compliant"
}

Ready to get started?

Create your account and start securing your iOS app today.