Apidog 2.8.41から2.8.44までの4つの一般リリースを通じて、8月はエンタープライズAPI運用における3つの連携した部分、すなわち管理されたGit接続、ID駆動型プロジェクトアクセス、そしてより有用で追跡可能なAPIベースの管理を強化しました。
エンタープライズAPIチームは、APIプラットフォーム自体以外のシステムを通じて、リポジトリ、ID、メンバーシップを管理する機会が増えています。今月、Apidogはこれらの連携を改善するとともに、プロジェクトのセットアップ、インポート、ブランチ、ドキュメント、CLIワークフロー、テスト実行にわたる信頼性向上に焦点を当てたアップデートを提供します。
主なアップデートは以下の通りです。
- GitHub Enterprise Cloud: 専用の
*.ghe.comドメイン上にあるデータレジデンシーデプロイメントにApidogを接続します。 - SSOガバナンスとプロジェクトアクセス: エンタープライズSSOセッションを組織の作業に集中させ、SAMLグループマッピングを通じてプロジェクト権限を初期化します。
- エンタープライズ管理API: より有用な組織メンバーデータを取得し、明示的なプロジェクトアクセス初期化でチームオンボーディングを自動化し、サポートされるAPI駆動型管理操作を監査証跡に組み込みます。
これら3つの主要なアップデートの後に、環境、ポリシー、国際化、仕様、ワークフローに関する追加の改善点がまとめられています。
1. ☁️ データレジデンシーワークフローのためのGitHub Enterprise Cloud
データレジデンシーを持つGitHub Enterprise Cloudの顧客は、公開されているgithub.comドメインの代わりに、専用の*.ghe.comドメインでリポジトリをホストできます。これまで、これは組織の既存のGitHub環境外に管理されたリポジトリを移動させることなくApidogのGitワークフローを使用したいチームにとってギャップを生み出していました。
組織の*.ghe.comホストに接続する
組織管理者は、OAuth AppのクライアントIDとクライアントシークレットとともにGitHub Enterprise Cloudホストを設定できるようになりました。認証フローは設定されたエンタープライズホストを使用し、ApidogがサポートされるGit操作に必要な組織、リポジトリ、ブランチ、ファイルにアクセスできるようにします。
この接続は、3つの実用的なワークフローに適用されます。
- Git接続: 組織によって管理されているリポジトリとブランチを介してAPI定義を操作します。
- リポジトリインポート: エンタープライズリポジトリからOpenAPIまたはSwaggerファイルをApidogにインポートします。
- OpenAPIバックアップ: API定義をチームが選択したエンタープライズリポジトリとブランチにバックアップします。
その結果、継続性がもたらされます。チームは、ApidogのGitベースのインポート、バックアップ、コラボレーションワークフローを使用しながら、リポジトリガバナンスとデータレジデンシーモデルを維持できます。
範囲: このアップデートは、専用の*.ghe.com SaaSドメイン上でのGitHub Enterprise Cloudデータレジデンシーデプロイメントに限定されます。自己ホスト型GitHub Enterprise Serverドメインの一般的なサポートを追加するものではありません。2. 🛡️ SSOガバナンスとプロジェクトアクセスの強化
エンタープライズSSOは、ユーザーを認証する以上の機能を持つべきです。セッションを組織の意図するワークスペースに集中させ、IDプロバイダーのメンバーシップを作業が行われるプロジェクトへの予測可能なアクセスに変換するべきです。
エンタープライズSSOセッションを組織の作業に集中させる
SSOセッションの分離を有効にすることで、Apidogは個人のチームやプロジェクトへのエントリーポイントを減らします。また、組織の作業を個人のスペースに移動、コピー、またはクローンできる特定の操作を制限します。ユーザーはSSOセッションに関連付けられた組織とチームに集中し、管理者はエンタープライズと個人のワークフロー間のより明確な分離を得られます。
これらの制御は、SSOセッションの分離を有効にしない組織にとって通常の体験を変更することなく、意図されたアクセス境界を強化します。
チームメンバーシップをプロジェクトレベルのアクセスに持ち込む
SAMLグループマッピングは、同期されたチームの下にあるプロジェクトへのアクセスを初期化することで、組織およびチームメンバーシップを超えて拡張されるようになりました。初期プロジェクトロールは以下の簡単なルールに従います。
| 同期されたチームロール | チーム内のプロジェクトへの初期アクセス権 |
|---|---|
| チーム管理者 | 編集者 |
| その他のチームメンバー | 読み取り専用 |
マッピングされたユーザーがチームから削除されると、Apidogは関連するプロジェクトメンバーシップも同期します。これにより、IDプロバイダーグループ、チームロール、サインイン後にユーザーが必要とするプロジェクト権限の間の運用上のギャップが解消されます。
なぜ重要か: 管理者はオンボーディングやオフボーディング後のプロジェクトメンバーシップの修正にかかる時間を削減でき、ユーザーは明確で一貫した初期アクセスレベルでチームプロジェクトに参加できます。
3. 📋 より完全で監査可能なエンタープライズ管理API
エンタープライズ管理者は、メンバーのインベントリ、IDシステムの接続、および日常的な管理の自動化にAPIを使用することがよくあります。これらのワークフローは、APIが有用なメンバーデータを返し、オンボーディングの動作が明確かつ保護されており、自動化された操作がガバナンスチームに対して可視である場合にのみ信頼できます。
より有用な組織メンバーデータを取得する
組織メンバーAPIは、既存のメンバーシップ情報に加えて、メールアドレスとより信頼性の高いメンバー名を提供するようになりました。
GET /v1/organizations/{organizationId}/members
メンバーがニックネームを設定していない場合、Apidogは他の利用可能なプロファイル情報から名前を返します。利用可能なメールアドレスがないメンバー（該当する保留中またはプロビジョニング済みのレコードを含む）は、曖昧な欠損フィールドではなく、明示的なnull値を返します。
これにより、APIは以下の用途でより実用的になります。
- メンバーインベントリ: 管理者がレビューのために一般的に必要とする情報で組織メンバーを識別します。
- 自動同期: 外部のIDおよび管理ワークフローで安定したメンバーデータを使用します。
- アクセスレビュー: 基本的な詳細のために個別の手動CSVエクスポートに依存することなく、メンバーシップレコードを比較します。
APIを通じてチームロールを割り当て、プロジェクトアクセスを初期化する
エンタープライズ管理者は、外部APIを通じて、メールでユーザーをチームに追加し、サポートされている組み込みチームロールを割り当てることができるようになりました。
POST /v1/team-access-grants
各リクエストは、チームロール（管理者、メンバー、ゲスト）と、チームの下にある既存のプロジェクトへのアクセスをどのように初期化するかを明示的に選択します。mappedの場合、Apidogは選択されたチームロールに従って不足しているプロジェクトアクセスを初期化し、既存の有効なプロジェクトロールを保持します。noneの場合、ユーザーはプロジェクトメンバーの権限を受け取らずにチームに参加するため、アクセスは個別に割り当てられます。
このエンドポイントは、まだ組織に参加していないユーザーへの招待、および以前チームを離れたメンバーの復元もサポートしています。既存のアクティブまたは保留中のチームメンバーとチームオーナーは意図しない変更から保護されており、自動化されたオンボーディングワークフローでの繰り返し呼び出しをより安全にします。
範囲: プロジェクトアクセスの初期化は、ユーザーが初めて参加または復元されたときに、チームの下にすでに存在するプロジェクトに適用されます。継続的に権限を同期したり、将来のプロジェクトに自動的に適用したりするものではなく、このエンドポイントはチームオーナー、請求管理者、またはカスタムチームロールを割り当てません。
サポートされるAPI駆動型管理を監査証跡に保持する
既存の監査イベントに対応するサポートされている外部管理API操作が、監査証跡に組み込まれるようになりました。これにより、ガバナンスチームは、Apidogインターフェースで実行されたアクションと自動化を通じて実行されたサポートされているアクションとの間の連続性をより良く確保できます。
より豊富なメンバーデータ、より安全なチームアクセス自動化、および広範な監査範囲が相まって、運用レビューに必要な可視性を失うことなく、エンタープライズ管理をより簡単に自動化できるようになります。
範囲: 監査範囲は、既存の監査イベントに関連付けられたサポートされている外部API操作に適用されます。これは、すべてのAPIリクエストまたは管理エンドポイントの普遍的なロギングとして解釈されるべきではありません。
✨ その他の改善点
8月には、環境設定、エンタープライズポリシー、国際化、仕様ワークフロー、およびプロジェクト管理にわたる一連の集中的な改善も含まれています。
エンタープライズおよび環境管理
- 組織メンバーシップポリシー: エンタープライズ管理者は、組織メンバーシップを特定のメールアドレスを持つメンバーに制限することができ、承認されたIDルールとアクセスを連携させるのに役立ちます。
- 招待報酬ポリシー: 組織は、組織とそのチームまたはプロジェクトから送信された招待に対するクレジット報酬と関連メールを無効にできます。
- モジュールベースURLナビゲーションの高速化: プロジェクトに5つ以上のモジュールがある場合、最初の5つ以降のエントリは自動的に折りたたまれ、検索によってユーザーが必要なサービス設定を見つけるのに役立ちます。
- ローカライズされたシステムメール: Apidogのシステムメールは受信者の選択した言語に従うようになり、Apidogの言語設定が利用できない場合は英語が使用されます。
- より管理しやすい組織所有のチーム: 組織オーナーと管理者は、各チームオーナーとオーナーのステータスを表示し、これらのフィールドでチームを検索またはフィルタリングし、1つまたは複数のチームの所有権を転送できます。これにより、所有権が変更された場合に、組織管理下の個人ワークスペースをより簡単に特定し、引き渡すことができます。
- より明確なプロジェクトメンバー管理: 一括メンバー編集、メンバー詳細ダイアログ、および権限設定がより操作しやすくなり、チームオーナーのロールはサポートされていない変更から保護されます。
- 改良されたエンタープライズ管理ページ: より一貫性のあるレイアウト、ヘルプリンク、およびアップグレードプレゼンテーションにより、既存の権限ロジックを変更することなく、エンタープライズ設定、ポリシー、監査ログ、シークレットスキャナー、SAML SSOページ間のナビゲーションが改善されます。
プロジェクトのセットアップ、インポート、および仕様
- プロジェクト作成時のより安全なモード切り替え: プロジェクト作成フォームにすでに入力された情報は、一般モードと仕様モードを切り替えても保持されます。
- Postmanファイルインポートの改善: インポートがグローバル変数をサポートし、変数名のスペースを自動的に処理するようになり、移行後のクリーンアップ作業が軽減されます。
- 仕様モードでのクロスファイル
$refサポートの向上: エンドポイントプレビューは、個別のOpenAPIファイルに保存されているサポート対象のリクエストボディ、スキーマ、およびレスポンスを解決できます。参照されたファイル全体でのSpectral lint、完全なエンドポイント参照、およびフォームモードのクロスファイル参照はこの範囲外です。
これらの改善が一体となって、リリースの3つの主要なエンタープライズワークフローと競合することなく、繰り返し発生するセットアップと管理の摩擦を軽減します。
🛠️ 注目すべきバグ修正
8月のリリースでは、Gitブランチ、OpenAPIのインポートとエクスポート、共有ドキュメント、CLIで作成されたデータ、およびテスト実行における信頼性の問題も対処されました。最も重要な修正は、3つのワークフローグループに分類されます。
より安全なブランチ、インポート、エクスポート、およびコード生成ワークフロー
- Apidog CLIのOpenAPIインポートは、誤ってメインブランチに書き込むのではなく、ユーザーが選択したブランチに書き込むようになりました。
- サブブランチからのリリースドキュメントのエクスポートに、関連のないモジュールや空のフォルダからのエンドポイントが含まれなくなりました。
- 複数ブランチのマージは、エンドポイント、テストシナリオ、その他のリソースをより確実にターゲットブランチに引き継ぐようになりました。
- OpenAPIインポート時にGitリポジトリ接続を作成アクションが正しく応答するようになりました。
- OpenAPIおよびCLIのエクスポートは、意図せず広範なエンドポイントセットを含めるのではなく、選択されたモジュール、タグ、およびフォルダを尊重するようになりました。
- モジュール間で参照されるスキーマは、コード生成時に、より確実に保持されるようになりました。
- AND関連のセキュリティスキームは、不正確な内部表現にマージされるのではなく、正しくエクスポートされるようになりました。
より正確な検証と共有ドキュメント
- 厳格モードのレスポンス検証が、
allOfで構成されたスキーマを正しく処理するようになりました。 Additional propertiesを通じて参照されるスキーマが、共有APIドキュメントで正しく表示されるようになりました。- デフォルトの例が、共有ドキュメントで正しく表示されるようになりました。
- サインアウトしたユーザーが公開プロジェクトを訪れた際に、Markdownドキュメントのタブが完全にレンダリングされるようになりました。
より信頼性の高いCLIデータとテスト実行
- AIまたはApidog CLIを通じて作成されたグローバル変数が、空のクライアント側変数名を生成しなくなりました。
- Apidog CLIによって作成された無効なタグ値が、フロントエンドアクセスエラーを引き起こさなくなりました。
--scenarioなしで作成されたプロジェクトレベルのテストデータが、データリストに表示されたままになります。- SSEリクエストの実行中に、リクエストが完了した後だけでなく、プリプロセッサーとポストプロセッサーの実行詳細がコンソールに表示されるようになりました。
- テスト実行で長文データセット変数が使用されている場合でも、データセット名が表示されたままになります。
これらの修正により、正しいワークフローが誤ったブランチの宛先、不完全なエクスポート、欠落したドキュメント、または誤解を招くテストフィードバックを生成する可能性が低減されます。
🌟 これが意味すること
8月の主要なアップデートは、エンタープライズAPI運用モデルの3つの連携した部分を強化します。
| 焦点 | 改善点 | なぜ重要か |
|---|---|---|
| 管理されたGit接続 | Apidogは、Git接続、リポジトリインポート、OpenAPIバックアップのために、*.ghe.com上のGitHub Enterprise Cloudデータレジデンシーホストに接続できます。 |
チームは、組織が管理するGitHub環境とブランチ構造でリポジトリを保持できます。 |
| IDからプロジェクトへのアクセス | SSOセッションは個人スペースへのエントリーポイントを減らし、SAMLグループマッピングはプロジェクトメンバーシップを初期化および維持します。 | オンボーディングとオフボーディングがより予測可能になり、手動での権限修正が少なくなります。 |
| 監査可能な管理 | 組織メンバーAPIはより有用なIDデータを返し、チームアクセス許可APIは明示的なプロジェクトアクセス初期化によって保護されたチームオンボーディングを自動化し、サポートされている外部管理操作は既存の監査イベントに反映されます。 | チームは、オンボーディング、インベントリ、アクセスレビュー、およびガバナンスに必要な制御と可視性を手放すことなく、より多くの管理を自動化できます。 |
追加された環境、ポリシー、仕様、および信頼性の改善により、日常のワークフローはより信頼性が高まりますが、より大きな方向性は一貫しています。それは、エンタープライズAPIプログラムが成長するにつれて、リポジトリガバナンス、IDアクセス、および管理自動化を連携させることです。
💬 会話に参加する
他のAPIエンジニアやApidogチームとつながりましょう。
- リアルタイムの議論とサポートのために、Discordコミュニティに参加してください。
- 技術的な会話のために、Slackコミュニティに参加してください。
- 最新のアップデートについては、X (旧Twitter)とLinkedInでフォローしてください。
追伸：個別のリリースノートについては、バージョン2.8.41、2.8.42、2.8.43、および2.8.44を含むApidogチェンジログをご覧ください。
敬具
Apidogチーム