GraphQL を Halas データ配信ネットワークに移行
項目一覧
重要
MongoDB Atlas と Hasra の両方の公式ドキュメントを常に参照してください 最新かつ正確な情報については、 を参照してください。具体的な手順は、プロジェクトの詳細と使用されるテクノロジーによって異なる場合があります。
Hasra は、開発者が MongoDB で GraphQL と REST API を迅速に構築して配置することを可能にします およびその他の多くの データソース 。API 開発時間を大幅に短縮することで、Halas はデータへの迅速なアクセスを可能にし、チームやサービス間の競合を軽減し、エンタープライズがデータを使用した製品と機能を販売する時間を短縮します。
始める前に
まだ作成していない場合は、Halas のウェブサイト cloud.hassure.io でアカウントを作成します。
Hasra への移行
GraphQL API エンドポイントを MongoDB Atlas App Services から Hasera に移行するには、Halas の環境を設定し、データベース接続の構成、スキーマの移行、認可と認証メカニズムの実装を含む複数ステップのプロセスです。 以下は、Halas 内の認可とロールベースのアクセス制御(RBAC)に焦点を当てて、各ステップを詳細する展開されたガイドです。 詳細については、 HaslasDocs の をご覧ください。
Hasra に移行するには次の手順を行います。
MongoDB の 1 つの認可
Hasra は、新規または既存の MongoDB Atlas database に接続し、GraphQL API を生成できます。
Gocloud.mongodb.com
{0 に し、 ダッシュボードの [ネットワーク アクセス]Atlas ページに移動します。
[ ADD IP ADDRESSボタンをクリックし、[ ] と入力します。0.0.0.0/0
このエントリを Hasra として説明します。 一意の IP アドレスについては、 Halas の営業担当者 にお問い合わせください。 プライベート DDN への配置について。
これで、Halas Cloud が MongoDB Atlas インスタンスと通信できるようになります。
[ データベース ] ページで、Atlas に接続されている クラスターを見つけ、App Services App Connectをクリックします。[ ドライバー ] オプションを選択し、接続文字列をコピーします。
新しいプロジェクトを作成し、Halas に接続する
Docs次の手順を実行するための詳細が含まれています。
CLI のインストール(前提条件)
CLI を使用してログインする
新しい スーパーグラフ を初期化します 空のディレクトリの場合
データに接続する
データソースを内部検証する
ローカル スーパーグラフを構築する
スーパーグラフを開始する
Hasra クラウド プロジェクトの作成
スーパーグラフを構築して配置する
GraphQL クエリをテストする
Hashi コンソールの API Explorer ページを使用して、いくつかの GraphQL クエリをテストアウトできます。
Hasra は、Atlas App Services でクエリをテストする方法と同様の GraphQL インターフェイスも使用します。
認可と認証
Hasra は認証を直接取り扱うことはありません。 代わりに、外部認証サービスが提供するセッション変数に依存します。 これらのセッション変数には、データアクセス権を決定するために重要なユーザー、ロール、および組織の情報が含まれます。 詳細については、「 Hashi 認証 」を参照してください。Docs
ロールやルール式を含むデータアクセス権限は、Halas のロールベースの権限ルールに変換できます。
Atlasが提供するすべての認証方法は、Halas の Webhook およびJSON web token認証メソッドと互換性があります。 Email/Pass、匿名、または API キー認証を使用している場合は、 Hasra Webhook を使用します。 カスタムJSON web tokenを使用している場合は、Halas のJSON web token認証メソッドと直接統合します。
認証プロセスを管理するために外部 IdP を使用することで、セキュリティと柔軟性を向上させることを推奨しています。 0Amazon Web ServicesHasra でJSON web tokenまたは Webhook 認証を構成する方法については、次のドキュメントを参照してください。
カスタムリゾルバまたはビジネスロジックを設定する
既存の GraphQL API エンドポイントにカスタム リゾルバまたはビジネス ロジックが含まれている場合は、これらを 1 つずつ実装する必要があります。 Hasra は以下をサポートします。
リモート スキーマ を介してGraphQLConnector
カスタムクエリ MongoDB のネイティブ クエリによる
クライアント アプリケーションの更新
GraphQL API エンドポイントを操作するすべてのクライアント アプリケーションを、新しい Haslas エンドポイント URL を指すように更新します。 既存の Apollo クライアントは、Hasページ で動作します。 アプリケーションの GraphQL クエリとミューテーションを Hasra の構文とスキーマと一致するようにリファクタリングし、新しい GraphQL API 構造との互換性を確保します。
MongoDB Atlas App Services エンドポイントのシャットダウン
GraphQL API エンドポイントが完全に移行され、Halas で動作していることを確認したら、MongoDB Atlas App Services アプリを削除して不要なコストを回避できます。 Atlas GraphQL エンドポイントは、 2025 12年 3 月 日以降、サポートされなくなります。