Help Center
Find answers, tutorials, and support resources
Getting Started
Quick start guides and first integration steps
Integration Guides
Detailed integration tutorials for iOS and server
Troubleshooting
Common issues and debugging tips
Getting Started
1. Sign Up and Choose a Plan
Create your Grantiva account and select the plan that fits your needs:
- Basic: Perfect for small apps and testing
- Professional: For growing apps with custom needs
- Enterprise: For large-scale applications
2. Add Your App
Register your iOS app with its Bundle ID and Team ID. No API keys needed - authentication is automatic!
3. Install the SDK
pod 'Grantiva'
Or with Swift Package Manager:
https://github.com/grantiva/ios-sdk
4. Initialize and Attest
import Grantiva
// Initialize on app launch
Grantiva.shared.initialize()
// Attest device
Grantiva.shared.attestDevice { result in
switch result {
case .success(let token):
// Use JWT token for API calls
case .failure(let error):
// Handle attestation failure
}
}
Integration Guides
iOS Integration
Server Integration
Troubleshooting
Attestation fails with error code 401
This usually means your Bundle ID or Team ID doesn't match what's registered. Check that:
- Your app's Bundle ID exactly matches the one in your dashboard
- You're using the correct Team ID (found in Apple Developer portal)
- Your app is signed with the correct provisioning profile
Device shows as high risk but shouldn't
Risk scores consider multiple factors. Common causes for elevated risk:
- Device is jailbroken or rooted
- App binary has been modified
- Running on simulator (development only)
- Unusual usage patterns detected
Contact support if you believe the risk score is incorrect.
Reached attestation limit
You've reached your monthly attestation limit. Options:
- Upgrade to a higher plan for more attestations
- Wait for the next billing cycle (limits reset monthly)
- Contact sales for custom limits (Enterprise)
JWT token validation fails
Ensure you're validating tokens correctly:
- Use our public key to verify the signature
- Check token expiration (tokens expire after 24 hours)
- Verify the issuer is "grantiva.com"
- Validate custom claims match your configuration
Need More Help?
Our support team is here to help you succeed.
Frequently Asked Questions
Do I need API keys for iOS integration?
No! Grantiva automatically identifies your app using its Bundle ID and Team ID through Apple's App Attest. API keys are only needed for server-to-server communication (Enterprise tier).
What happens when I reach my attestation limit?
The Free plan has a hard cap at 1,000 attestations - you'll need to upgrade to continue service. Paid plans have soft caps - you'll be charged for overages but your total bill won't exceed: Basic caps at $79, Professional at $300, Growth at $799, Enterprise at $2,999.
Can I test during development?
Yes! The SDK includes a development mode that works with simulators and test devices. Development attestations don't count against your quota.
How quickly can I get started?
Most developers have Grantiva integrated and running in under 30 minutes. Our SDK is designed to be drop-in ready with minimal configuration.