Vast.ai エンタープライズ RBAC

概要

Vast.ai 統合のためのエンタープライズグレードのアクセス制御を設定します。

前提条件

• Vast.ai エンタープライズティアサブスクリプション
• SAML/OIDC をサポートするアイデンティティプロバイダー(IdP)
• ロールベースのアクセスパターンの理解
• 監査ログインフラストラクチャ

ロール定義

ロール	権限	ユースケース
Admin	フルアクセス	プラットフォーム管理者
Developer	読み取り/書き込み、削除なし	アクティブな開発
Viewer	読み取り専用	ステークホルダー、監査者
Service	API アクセスのみ	自動化システム

ロール実装

enum Vast.aiRole {
  Admin = 'admin',
  Developer = 'developer',
  Viewer = 'viewer',
  Service = 'service',
}

interface Vast.aiPermissions {
  read: boolean;
  write: boolean;
  delete: boolean;
  admin: boolean;
}

const ROLE_PERMISSIONS: Record<Vast.aiRole, Vast.aiPermissions> = {
  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: Vast.aiRole,
  action: keyof Vast.aiPermissions
): boolean {
  return ROLE_PERMISSIONS[role][action];
}

SSO 統合

SAML 設定

// Vast.ai SAML セットアップ
const samlConfig = {
  entryPoint: 'https://idp.company.com/saml/sso',
  issuer: 'https://vastai.com/saml/metadata',
  cert: process.env.SAML_CERT,
  callbackUrl: 'https://app.yourcompany.com/auth/vastai/callback',
};

// IdP グループを Vast.ai ロールにマッピング
const groupRoleMapping: Record<string, Vast.aiRole> = {
  'Engineering': Vast.aiRole.Developer,
  'Platform-Admins': Vast.aiRole.Admin,
  'Data-Team': Vast.aiRole.Viewer,
};

OAuth2/OIDC 統合

import { OAuth2Client } from '@vastai/sdk';

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

組織管理

interface Vast.aiOrganization {
  id: string;
  name: string;
  ssoEnabled: boolean;
  enforceSso: boolean;
  allowedDomains: string[];
  defaultRole: Vast.aiRole;
}

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

アクセス制御ミドルウェア

function requireVast.aiPermission(
  requiredPermission: keyof Vast.aiPermissions
) {
  return async (req: Request, res: Response, next: NextFunction) => {
    const user = req.user as { vastaiRole: Vast.aiRole };

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

    next();
  };
}

// 使用例
app.delete('/vastai/resource/:id',
  requireVast.aiPermission('delete'),
  deleteResourceHandler
);

監査証跡

interface Vast.aiAuditEntry {
  timestamp: Date;
  userId: string;
  role: Vast.aiRole;
  action: string;
  resource: string;
  success: boolean;
  ipAddress: string;
}

async function logVast.aiAccess(entry: Vast.aiAuditEntry): Promise<void> {
  await auditDb.insert(entry);

  // 疑わしいアクティビティがあればアラート
  if (entry.action === 'delete' && !entry.success) {
    await alertOnSuspiciousActivity(entry);
  }
}

手順

ステップ 1: ロールの定義

組織のロールを Vast.ai 権限にマッピングします。

ステップ 2: SSO の設定

IdP との SAML または OIDC 統合をセットアップします。

ステップ 3: ミドルウェアの実装

API エンドポイントに権限チェックを追加します。

ステップ 4: 監査ログの有効化

コンプライアンス用に全アクセスを追跡します。

出力

• ロール定義が実装される
• SSO 統合が設定される
• 権限ミドルウェアがアクティブになる
• 監査証跡が有効になる

エラー処理

問題	原因	解決策
SSO ログイン失敗	間違ったコールバック URL	IdP 設定を確認
アクセス拒否	ロールマッピングがない	グループマッピングを更新
トークン有効期限切れ	TTL が短い	トークンリフレッシュロジックを実装
監査ログの欠落	非同期ログが失敗	ログパイプラインを確認

例

クイック権限チェック

if (!checkPermission(user.role, 'write')) {
  throw new ForbiddenError('Write permission required');
}

リソース

• Vast.ai エンタープライズガイド
• SAML 2.0 仕様
• OpenID Connect 仕様

次のステップ

大規模なマイグレーションについては、vastai-migration-deep-dive を参照してください。