perplexity-enterprise-rbac by jeremylongshore

---
name: perplexity-enterprise-rbac
description: |
  Configure Perplexity enterprise SSO, role-based access control, and organization management.
  Use when implementing SSO integration, configuring role-based permissions,
  or setting up organization-level controls for Perplexity.
  Trigger with phrases like "perplexity SSO", "perplexity RBAC",
  "perplexity enterprise", "perplexity roles", "perplexity permissions", "perplexity SAML".
allowed-tools: Read, Write, Edit
version: 1.0.0
license: MIT
author: Jeremy Longshore <[email protected]>
---

# Perplexity Enterprise RBAC

## Overview
Configure enterprise-grade access control for Perplexity integrations.

## Prerequisites
- Perplexity Enterprise tier subscription
- Identity Provider (IdP) with SAML/OIDC support
- Understanding of role-based access patterns
- Audit logging infrastructure

## Role Definitions

| Role | Permissions | Use Case |
|------|-------------|----------|
| Admin | Full access | Platform administrators |
| Developer | Read/write, no delete | Active development |
| Viewer | Read-only | Stakeholders, auditors |
| Service | API access only | Automated systems |

## Role Implementation

```typescript
enum PerplexityRole {
  Admin = 'admin',
  Developer = 'developer',
  Viewer = 'viewer',
  Service = 'service',
}

interface PerplexityPermissions {
  read: boolean;
  write: boolean;
  delete: boolean;
  admin: boolean;
}

const ROLE_PERMISSIONS: Record<PerplexityRole, PerplexityPermissions> = {
  admin: { read: true, write: true, delete: true, admin: true },
  developer: { read: true, write: true, delete: false, admin: false },
  viewer: { read: true, write: false, delete: false, admin: false },
  service: { read: true, write: true, delete: false, admin: false },
};

function checkPermission(
  role: PerplexityRole,
  action: keyof PerplexityPermissions
): boolean {
  return ROLE_PERMISSIONS[role][action];
}
```

## SSO Integration

### SAML Configuration

```typescript
// Perplexity SAML setup
const samlConfig = {
  entryPoint: 'https://idp.company.com/saml/sso',
  issuer: 'https://perplexity.com/saml/metadata',
  cert: process.env.SAML_CERT,
  callbackUrl: 'https://app.yourcompany.com/auth/perplexity/callback',
};

// Map IdP groups to Perplexity roles
const groupRoleMapping: Record<string, PerplexityRole> = {
  'Engineering': PerplexityRole.Developer,
  'Platform-Admins': PerplexityRole.Admin,
  'Data-Team': PerplexityRole.Viewer,
};
```

### OAuth2/OIDC Integration

```typescript
import { OAuth2Client } from '@perplexity/sdk';

const oauthClient = new OAuth2Client({
  clientId: process.env.PERPLEXITY_OAUTH_CLIENT_ID!,
  clientSecret: process.env.PERPLEXITY_OAUTH_CLIENT_SECRET!,
  redirectUri: 'https://app.yourcompany.com/auth/perplexity/callback',
  scopes: ['read', 'write'],
});
```

## Organization Management

```typescript
interface PerplexityOrganization {
  id: string;
  name: string;
  ssoEnabled: boolean;
  enforceSso: boolean;
  allowedDomains: string[];
  defaultRole: PerplexityRole;
}

async function createOrganization(
  config: PerplexityOrganization
): Promise<void> {
  await perplexityClient.organizations.create({
    ...config,
    settings: {
      sso: {
        enabled: config.ssoEnabled,
        enforced: config.enforceSso,
        domains: config.allowedDomains,
      },
    },
  });
}
```

## Access Control Middleware

```typescript
function requirePerplexityPermission(
  requiredPermission: keyof PerplexityPermissions
) {
  return async (req: Request, res: Response, next: NextFunction) => {
    const user = req.user as { perplexityRole: PerplexityRole };

    if (!checkPermission(user.perplexityRole, requiredPermission)) {
      return res.status(403).json({
        error: 'Forbidden',
        message: `Missing permission: ${requiredPermission}`,
      });
    }

    next();
  };
}

// Usage
app.delete('/perplexity/resource/:id',
  requirePerplexityPermission('delete'),
  deleteResourceHandler
);
```

## Audit Trail

```typescript
interface PerplexityAuditEntry {
  timestamp: Date;
  userId: string;
  role: PerplexityRole;
  action: string;
  resource: string;
  success: boolean;
  ipAddress: string;
}

async function logPerplexityAccess(entry: PerplexityAuditEntry): Promise<void> {
  await auditDb.insert(entry);

  // Alert on suspicious activity
  if (entry.action === 'delete' && !entry.success) {
    await alertOnSuspiciousActivity(entry);
  }
}
```

## Instructions

### Step 1: Define Roles
Map organizational roles to Perplexity permissions.

### Step 2: Configure SSO
Set up SAML or OIDC integration with your IdP.

### Step 3: Implement Middleware
Add permission checks to API endpoints.

### Step 4: Enable Audit Logging
Track all access for compliance.

## Output
- Role definitions implemented
- SSO integration configured
- Permission middleware active
- Audit trail enabled

## Error Handling
| Issue | Cause | Solution |
|-------|-------|----------|
| SSO login fails | Wrong callback URL | Verify IdP config |
| Permission denied | Missing role mapping | Update group mappings |
| Token expired | Short TTL | Refresh token logic |
| Audit gaps | Async logging failed | Check log pipeline |

## Examples

### Quick Permission Check
```typescript
if (!checkPermission(user.role, 'write')) {
  throw new ForbiddenError('Write permission required');
}
```

## Resources
- [Perplexity Enterprise Guide](https://docs.perplexity.com/enterprise)
- [SAML 2.0 Specification](https://wiki.oasis-open.org/security/FrontPage)
- [OpenID Connect Spec](https://openid.net/specs/openid-connect-core-1_0.html)

## Next Steps
For major migrations, see `perplexity-migration-deep-dive`.