https://github.com/aporthq/aport-integrations
🛡️ Community-built integrations, SDKs, and tools for APort - the neutral trust rail for AI agents. Join Hacktoberfest 2025!
https://github.com/aporthq/aport-integrations
agent-identity agent-security ai ai-agents crewai django express fastapi hacktoberfest hacktoberfest-accepted integrations langchain middleware nextjs nodejs openapi policy-enforcement sdk shopify stripe
Last synced: about 1 month ago
JSON representation
🛡️ Community-built integrations, SDKs, and tools for APort - the neutral trust rail for AI agents. Join Hacktoberfest 2025!
- Host: GitHub
- URL: https://github.com/aporthq/aport-integrations
- Owner: aporthq
- License: mit
- Created: 2025-10-01T20:52:17.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-10-02T01:33:54.000Z (4 months ago)
- Last Synced: 2025-10-02T03:25:44.309Z (4 months ago)
- Topics: agent-identity, agent-security, ai, ai-agents, crewai, django, express, fastapi, hacktoberfest, hacktoberfest-accepted, integrations, langchain, middleware, nextjs, nodejs, openapi, policy-enforcement, sdk, shopify, stripe
- Language: JavaScript
- Homepage: https://aport.io/
- Size: 99.6 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 22
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# 🛡️ APort Integrations
**Community-built integrations, SDKs, and tools for the APort ecosystem**
[](https://github.com/aporthq/aport-integrations/issues)
[](https://github.com/aporthq/aport-integrations/pulls)
[](LICENSE)
[](https://hacktoberfest.digitalocean.com/)
[🌐 APort Website](https://aport.io) • [📚 Documentation](https://aport.io/docs) • [🚀 Try APort](https://aport.io/dashboard) • [💬 Discord](https://discord.gg/aport)
---
## 🎯 About APort Integrations
This repository houses community-contributed integrations, SDKs, middleware, and tools that extend APort's capabilities across different platforms, frameworks, and use cases. Each integration demonstrates how to implement APort's agent identity verification and policy enforcement in real-world scenarios.
### 🏆 What Makes APort Special?
- **🆔 Agent Identity**: Portable passports with capabilities & limits
- **📋 Policy Packs**: Pre-built policies for common actions (refunds, data export, PR merges)
- **⚡ Real-time Verify**: Sub-100ms policy checks with global suspend capability
- **🔐 Multi-level Assurance**: Email, GitHub, Domain verification levels
- **🌐 Platform Agnostic**: Works across all platforms and frameworks
---
## 📦 Official SDKs
The official APort SDKs are maintained in the [aport-sdks repository](https://github.com/aporthq/aport-sdks).
### ✅ Currently Available
#### Node.js/JavaScript
- **Core SDK**: [@aporthq/sdk-node](https://github.com/aporthq/aport-sdks/tree/main/javascript) - Core Node.js SDK
- **Express Middleware**: [@aporthq/middleware-express](https://github.com/aporthq/aport-sdks/tree/main/express) - Express.js middleware
#### Python
- **Core SDK**: [aporthq-sdk-python](https://github.com/aporthq/aport-sdks/tree/main/python) - Core Python SDK
- **FastAPI Middleware**: [agent-passport-middleware-fastapi](https://github.com/aporthq/aport-sdks/tree/main/fastapi) - FastAPI middleware
### 🚧 In Development (Hacktoberfest 2025)
We're actively building more SDKs and integrations! Check out our [open issues](https://github.com/aporthq/aport-integrations/issues) to contribute:
#### High Priority SDKs
- **Go SDK** - Core Go SDK with Gin, Echo, Fiber middleware
- **PHP SDK** - Core PHP SDK with Laravel middleware
- **Ruby SDK** - Core Ruby SDK with Rails gem
#### Agent Framework Integrations
- **LangChain Integration** - Tool guard for LangChain
- **CrewAI Integration** - Task verification decorator
- **n8n Workflow Node** - Custom n8n node for policy checks
#### Platform Integrations
- **Zapier App** - Custom Zapier app for APort verification
- **GitHub App** - PR/Merge verification
- **Discord Bot** - Team verification workflows
#### Developer Experience
- **VS Code Extension** - Code snippets and syntax highlighting
- **Postman Collection** - API testing and CI/CD integration
- **CLI Tool** - Quick integration setup
#### E-commerce & Financial
- **Shopify App** - Refund protection for e-commerce
- **Stripe Integration** - Payment verification
- **Banking APIs** - Financial services integration
#### Protocol Bridges
- **OpenAPI Spec** - OpenAPI 3.1 specification for APort API
- **AP2 Bridge** - AP2 payment authorization bridge
- **SPIFFE/SPIRE** - Enterprise identity integration
## 🎉 Hacktoberfest 2025 Progress
We're actively building the APort ecosystem with **22+ open issues** and **6 issues already picked up** by contributors!
### 📊 Current Status
- **Total Issues**: 22 open issues
- **Issues Picked Up**: 6 (27% pickup rate in 8 hours!)
- **Total Bounty Pool**: $175+ USD
- **Categories**: 10+ different integration types
### 🏆 Most Popular Issues (Already Picked Up)
1. **Blog Post Tutorial** - 2 assignees
2. **n8n Workflow Node** - 1 assignee
3. **Go SDK** - 1 assignee
4. **Next.js Middleware** - 2 assignees
5. **AP2 Payment Bridge** - 2 assignees
6. **Zapier Custom App** - 1 assignee
### 🎯 Strategic Need for Comprehensive SDK Coverage
### **Agent Framework Coverage** (Highest Priority)
- **LangChain**: Most popular AI framework - needs tool guard integration
- **CrewAI**: Multi-agent orchestration - needs task verification decorator
- **n8n**: Low-code automation - needs custom verification node
- **LangGraph**: State machine workflows - needs checkpoint integration
- **Zapier**: No-code automation - needs custom app
### **E-commerce Platform Integration** (Design Partner Demos)
- **Shopify**: Complete app with refund guardrails
- **WooCommerce**: WordPress plugin for order verification
- **Stripe**: Connect payout verification
### **Developer Experience Tools** (Reduce Integration Friction)
- **CLI Tool**: `npx create-aport-integration` scaffolding
- **VS Code Extension**: Policy development with IntelliSense
- **Postman Collection**: Complete API testing suite
### **Framework Middleware** (Native Support)
- **Next.js**: App Router and Pages Router support
- **Django**: Python web framework middleware
- **Laravel**: PHP framework with Artisan commands
- **Rails**: Ruby gem with generators
- **Go Frameworks**: Gin, Echo, Fiber middleware
### **Protocol Bridges** (Universal Interoperability)
- **OpenAPI 3.1**: Complete API specification
- **AP2 Bridge**: Payment authorization integration
- **SPIFFE/SPIRE**: Enterprise identity federation
## 🚀 Quick Start
### 1. Browse Available Integrations
```bash
# Clone the repository
git clone https://github.com/aporthq/aport-integrations.git
cd aport-integrations
# Explore integrations by category
ls examples/
# agent-frameworks/ ecommerce/ developer-tools/ middleware/ protocol-bridges/
```
### 2. Try an Integration
```bash
# Example: LangChain Tool Guard
cd examples/agent-frameworks/langchain
npm install
npm run example
# Example: Express.js Middleware
cd examples/middleware/express
npm install
npm start
```
### 3. Create Your Own Integration
```bash
# Use our CLI to scaffold a new integration
npx create-aport-integration my-integration
cd my-integration
npm install
```
---
## 📁 Repository Structure
```
aport-integrations/
├── examples/ # Working integration examples
│ ├── agent-frameworks/ # LangChain, CrewAI, n8n, etc.
│ ├── ecommerce/ # Shopify, WooCommerce, Stripe
│ ├── middleware/ # Express, FastAPI, Django, etc.
│ └── protocol-bridges/ # OpenAPI, AP2, SPIFFE/SPIRE
├── tools/ # Developer tools and utilities
│ ├── cli/ # APort CLI for scaffolding
│ ├── vscode-extension/ # VS Code extension
│ └── postman-collection/ # Postman collection
├── templates/ # Integration scaffolding templates
│ ├── javascript-middleware/ # Express.js template
│ └── python-middleware/ # FastAPI template
├── sdk/ # References to official SDKs
│ └── README.md # Links to aport-sdks repository
└── docs/ # Integration documentation
```
### 📋 Directory Purposes
- **`examples/`** - **Working integration examples** that demonstrate real-world usage of APort
- **`tools/`** - **Developer tools and utilities** (CLI, VS Code extension, Postman collection)
- **`templates/`** - **Scaffolding templates** for quick integration development and consistent structure
- **`sdk/`** - **References to official APort SDKs** maintained in the aport-sdks repository
---
## 🎨 Integration Categories
### 🤖 **Agent Framework Integrations**
Make APort the default trust layer for AI agent frameworks.
| Integration | Description | Status | Maintainer |
|-------------|-------------|--------|------------|
| [LangChain Tool Guard](examples/agent-frameworks/langchain/) | Secure LangChain tools with APort verification | ✅ Active | Community |
| [CrewAI Task Decorator](examples/agent-frameworks/crewai/) | `@aport_verify` decorator for CrewAI tasks | ✅ Active | Community |
| [n8n APort Node](examples/agent-frameworks/n8n/) | Custom n8n node for APort verification | 🚧 In Progress | Community |
| [LangGraph Checkpoints](examples/agent-frameworks/langgraph/) | APort verification in LangGraph state machines | 📋 Planned | Community |
### 🛒 **E-commerce Platform Guardrails**
Prove the refund use case with working platform integrations.
| Integration | Description | Status | Maintainer |
|-------------|-------------|--------|------------|
| [Shopify Refund Guardrail](examples/ecommerce/shopify/) | Complete Shopify app with APort verification | ✅ Active | Community |
| [WooCommerce Plugin](examples/ecommerce/woocommerce/) | WordPress plugin for order/refund verification | 🚧 In Progress | Community |
| [Stripe Connect Verification](examples/ecommerce/stripe/) | Webhook handler for Stripe Connect payouts | 📋 Planned | Community |
### 🔧 **Developer Experience Tools**
Reduce APort integration time from hours to minutes.
| Tool | Description | Status | Maintainer |
|------|-------------|--------|------------|
| [APort CLI](tools/cli/) | `npx create-aport-integration` scaffolding tool | ✅ Active | Community |
| [VS Code Extension](tools/vscode-extension/) | Policy development with IntelliSense | 🚧 In Progress | Community |
| [Postman Collection](tools/postman-collection/) | Complete API testing collection | ✅ Active | Community |
### 🌉 **Protocol Bridges & Standards**
Position APort as the universal verify layer.
| Bridge | Description | Status | Maintainer |
|--------|-------------|--------|------------|
| [OpenAPI 3.1 Spec](examples/protocol-bridges/openapi/) | Complete OpenAPI specification | ✅ Active | Community |
| [AP2 Bridge](examples/protocol-bridges/ap2/) | APort passport authorization for AP2 payments | 📋 Planned | Community |
| [SPIFFE/SPIRE Integration](examples/protocol-bridges/spiffe/) | Enterprise identity federation | 📋 Planned | Community |
### 🛠️ **Core Framework SDKs & Middleware**
Native support for popular web frameworks.
| Framework | SDK/Middleware | Status | Maintainer |
|-----------|----------------|--------|------------|
| Next.js | Middleware package | ✅ Active | Community |
| Express.js | Middleware package | ✅ Active | Community |
| FastAPI | Middleware package | ✅ Active | Community |
| Django | Middleware package | 🚧 In Progress | Community |
| Laravel | Composer package | 📋 Planned | Community |
| Rails | Ruby gem | 📋 Planned | Community |
| Go | Official SDK | 🚧 In Progress | Community |
---
## 🎯 Real-World Examples
### 💳 E-commerce Refund Protection
```javascript
// Express.js with APort middleware
const { createAPortMiddleware } = require("@aporthq/middleware-express");
const aportMiddleware = createAPortMiddleware({
apiKey: process.env.APORT_API_KEY
});
app.post("/api/refunds",
aportMiddleware("finance.payment.refund.v1"),
async (req, res) => {
// Policy already verified! Check specific limits
const passport = req.aport.passport;
if (req.body.amount > passport.limits.refund_amount_max_per_tx) {
return res.status(403).json({
error: "Refund exceeds limit",
requested: req.body.amount,
limit: passport.limits.refund_amount_max_per_tx
});
}
// Process refund safely
const refund = await stripe.refunds.create({
amount: req.body.amount,
payment_intent: req.body.payment_intent
});
res.json({ success: true, refund });
}
);
```
### 🤖 LangChain Tool Protection
```python
# LangChain with APort Tool Guard
from aporthq_sdk import APortClient
from langchain.tools import Tool
def refund_tool(order_id: str, amount: float) -> str:
return f"Refunded ${amount} for order {order_id}"
# Initialize APort client
aport_client = APortClient(api_key=os.getenv("APORT_API_KEY"))
# Create protected tool wrapper
class APortToolGuard:
def __init__(self, tool, policy_pack, agent_id):
self.tool = tool
self.policy_pack = policy_pack
self.agent_id = agent_id
async def __call__(self, *args, **kwargs):
# Verify agent before tool execution
result = await aport_client.verify(self.policy_pack, self.agent_id)
if not result.verified:
raise Exception("Agent verification failed")
# Execute tool if verified
return self.tool(*args, **kwargs)
# Wrap tool with APort verification
protected_refund_tool = APortToolGuard(
tool=Tool(
name="refund_tool",
description="Process customer refunds",
func=refund_tool
),
policy_pack="finance.payment.refund.v1",
agent_id="agt_inst_xyz789"
)
# Use in agent
agent = initialize_agent([protected_refund_tool], llm, agent_type="zero-shot-react-description")
```
### 🔀 GitHub Actions Integration
```yaml
# .github/workflows/aport-verify.yml
name: APort Verify PR
on: [pull_request]
jobs:
verify:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: aporthq/policy-verify-action@v1
with:
agent-id: ${{ secrets.APORT_AGENT_ID }}
policy-pack: 'code.repository.merge.v1'
context: |
{
"repo": "${{ github.repository }}",
"base": "${{ github.event.pull_request.base.ref }}",
"head": "${{ github.event.pull_request.head.ref }}",
"files_changed": ${{ toJson(github.event.pull_request.changed_files) }}
}
```
---
## 🏆 Hacktoberfest 2025
We're participating in [Hacktoberfest 2025](https://hacktoberfest.digitalocean.com/)! Join us in building the future of AI agent security.
### 🎁 Rewards & Recognition
- **💰 Bounties**: $15-$50 per merged PR
- **👕 Swag**: APort Champion T-shirts for contributors
- **🏆 Grand Prizes**: Up to $150 for exceptional contributions
- **🌟 Recognition**: Featured on our website and social media
### 🚀 How to Participate
1. **Fork** this repository
2. **Browse** [open issues](https://github.com/aporthq/aport-integrations/issues) labeled `hacktoberfest`
3. **Claim** an issue by commenting "I'd like to work on this"
4. **Build** your integration following our [contribution guidelines](CONTRIBUTING.md)
5. **Submit** a pull request with your implementation
6. **Get paid** via Chimoney when your PR is merged!
### 🎯 Priority Issues
- [ ] [LangChain Tool Guard](https://github.com/aporthq/aport-integrations/issues/1) - $50
- [ ] [CrewAI Task Decorator](https://github.com/aporthq/aport-integrations/issues/2) - $50
- [ ] [Shopify Refund Guardrail](https://github.com/aporthq/aport-integrations/issues/3) - $50
- [ ] [APort CLI Tool](https://github.com/aporthq/aport-integrations/issues/4) - $50
[View all Hacktoberfest issues →](https://github.com/aporthq/aport-integrations/issues?q=is:issue+is:open+label:hacktoberfest)
## 📈 Key Insights from Issue Pickup Analysis
### What Contributors Want:
1. **"Good First Issue" Label** - 4/6 picked issues have this label
2. **Content Creation** - Blog posts and tutorials are highly attractive
3. **Integration & Middleware** - 5/6 issues are integration-related
4. **Automation Tools** - n8n and Zapier appeal to no-code audience
5. **Financial Use Cases** - Payment/AP2 bridge resonates strongly
### Best Practices for New Issues:
- Use `good-first-issue` label for beginner-friendly tasks
- Focus on content creation and developer experience
- Target specific frameworks (Next.js, Go, n8n, Zapier)
- Include clear success criteria and bounty amounts
- Provide scaffolding templates for complex integrations
---
## 🤝 Contributing
We love contributions! Whether you're fixing bugs, adding features, or creating new integrations, your work helps make APort better for everyone.
### 🚀 Quick Contribution Guide
1. **Browse Issues**: Check our [open Hacktoberfest issues](https://github.com/aporthq/aport-integrations/issues?q=is:issue+is:open+label:hacktoberfest)
2. **Use Templates**: Copy scaffolding templates from `/templates/` directory
3. **Follow Guidelines**: See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed instructions
4. **Get Rewarded**: Earn $5-$40 USD per completed issue!
### 🎯 High-Impact Areas
- **Agent Framework Integrations** (LangChain, CrewAI, n8n)
- **Platform Integrations** (Zapier, GitHub, Discord)
- **Developer Experience** (VS Code, CLI, Postman)
- **Content Creation** (Tutorials, blog posts, videos)
### 📋 Integration Requirements
- ✅ **Working Example**: Must include a complete, runnable example
- ✅ **Documentation**: Clear README with setup instructions
- ✅ **Tests**: Unit tests for core functionality
- ✅ **Error Handling**: Graceful failure modes
- ✅ **Security**: No hardcoded secrets or credentials
### 🎨 Code Standards
- **Language-specific**: Follow standard conventions (ESLint, Black, gofmt)
- **Documentation**: Include docstrings and comments
- **Testing**: Minimum 80% code coverage
- **Security**: Use environment variables for secrets
[Read our full Contributing Guide →](CONTRIBUTING.md)
---
## 📚 Resources
### 🔗 **APort Resources**
- [📖 Core Features](https://aport.io/features) - Complete list of APort Features
- [📖 Documentation](https://aport.io/docs) - Complete guides and API reference
- [🎮 Swagger Documentation](https://aport.io/api/swagger-ui) - Try APort in your browser
- [💡 Examples](https://github.com/aporthq/aport-examples) - Real-world implementations
### 🛠️ **Development Resources**
- [API Reference](https://aport.io/docs/) - Complete API documentation
- [Policy Packs](https://github.com/aporthq/aport-policies) - Pre-built policy definitions
- [SDKs](https://github.com/aporthq/aport-sdks) - Language-specific SDKs
- [Specification](https://github.com/aporthq/aport-spec) - AI Passport Specification
- [GitHub Actions](https://github.com/aporthq/policy-verify-action) - CI/CD integrations
### 💬 **Community**
- [GitHub Discussions](https://github.com/aporthq/aport-integrations/discussions) - Ask questions
---
## 📊 Project Status
| **Metric** | **Count** | **Status** |
|------------|-----------|------------|
| **🔧 Integrations** | 15+ | ✅ Active |
| **📦 SDKs** | 5+ | ✅ Active |
| **🛠️ Tools** | 8+ | ✅ Active |
| **👥 Contributors** | 25+ | 🌟 Growing |
| **⭐ Stars** | 100+ | 🚀 Rising |
---
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
---
**🛡️ Secure your AI agents. Trust but verify.**
[](https://github.com/aporthq)
[](https://twitter.com/aporthq)
[](https://linkedin.com/company/aporthq)
[](https://discord.gg/aport)
Made with ❤️ by the APort community