Drupal 7 デベロッパー ポータルのよくある質問

このセクションでは、Apigee コミュニティや Apigee サポートに寄せられた質問をまとめ、その中からよくある質問の回答を紹介します。

カテゴリ よくある質問
Drupal デベロッパー ポータルを設定する
ポータル環境を管理する
ポータルのデザインをカスタマイズする
ユーザーとアプリの登録をカスタマイズする
バックアップ、リカバリ、高可用性
ポータルを保護する
コンテンツ アクセスを制御する
メールと通知を構成する
問題のトラブルシューティングを行う
コードにアクセスする

Drupal デベロッパー ポータルを設定する

Drupal デベロッパー ポータルを設定するにはどうすればよいですか？

Drupal を使用するデベロッパー ポータルは、Apigee Edge の有料アカウントでのみリクエストできます（評価なし）。ポータル開発に Drupal を使う場合は、Apigee サポートにお問い合わせください。デベロッパー ポータルの作成について詳しくは、デベロッパー ポータルの作成をご覧ください。

ポータルでサポートされるブラウザとブラウザのバージョンを教えてください。

サポートされているソフトウェアとそのバージョンをご覧ください。

ポータル環境を管理する

パブリック クラウドでポータル環境を管理するにはどうすればよいですか？

Apigee では、ウェブサイト管理サービス Pantheon を使用して、Developer Services ポータルのクラウドベース バージョンをホストします。詳細については、Pantheon の使用をご覧ください。

Apigee では、ウェブサイト管理サービスの Acquia を使用して、EU での Developer Services ポータルのクラウドベース バージョンをホストしています。詳細については、Acquia の使用をご覧ください。

Pantheon と Acquia では、Drupal ベースのポータルを安全な環境で開発、テスト、公開するためのツールを用意しています。

プライベート クラウドでポータル環境を管理するにはどうすればよいですか？

Apigee Edge for Private Cloud のお客様は、自社でポータル環境を管理する必要があります。推奨事項については、Drupal development and server environment best practices をご覧ください。

パブリック クラウドのデベロッパー ポータルに Apigee のアップデートを適用するにはどうすればよいですか？

パブリック クラウドのデベロッパー ポータルに Apigee のアップデートを適用するには:

  • Pantheon: Apigee がポータルの新リリースを公開すると、メッセージが Pantheon ダッシュボードに表示されます。更新を定期的に確認して、セキュリティ アップデートをすみやかに適用する必要があります。詳細については、ポータルへの Apigee 更新の適用をご覧ください。

    注: 環境の「Status」領域に、ダッシュボードの左側にある「Status」メニュー項目からアクセスすると、Drupal モジュールに使用できる更新があるかどうかを確認できます。これらの更新は無視してください。Apigee は、Drupal モジュールの更新を次回のポータル リリースに自動的に組み込みます。Agipee による Drupal モジュールの自動更新を可能にすることで、最新のポータルコードに対してこれらの更新が確実にテストされた状態になります。通常の Apigee ポータル リリース サイクルを外れて Drupal モジュールを更新すると、予期しない問題が発生する可能性があります。

  • Acquia: Apigee は、定期的に、ポータル内のモジュールとテーマを自動的に最新のバージョンに更新します。更新は開発環境のみに行われ、他のポータル環境に移行する必要があることを示すタグが付けられます。詳細については、ポータルへのモジュールとテーマの更新の適用をご覧ください。

プライベート クラウドのデベロッパー ポータルに Apigee のアップデートを適用するにはどうすればよいですか？

Apigee Edge for Private Cloud のお客様は、Apigee が新しいリリースのポータルを公開すると、Developer Services ポータルのアップグレードの説明に従って、デベロッパー ポータルを最新バージョンにアップグレードできます。

Apigee Edge for Private Cloud のリリース間に、新しいバージョンの Drupal が利用可能である旨の通知を受け取ることがあります。新しいバージョンとは、Drupal 機能リリース、パッチ、セキュリティ アップデート、その他の種類の Drupal アップデートを意味します。セキュリティ アップデートの場合は、サイトの安全性を維持するため、Drupal のインストールをすみやかにアップグレードしてください。詳細については、Drupal バージョンの Private Cloud インストールのアップグレードをご覧ください。

ポータルのデザインをカスタマイズする

ポータルのデザインをカスタマイズするにはどうすればよいですか？

Drupal を使用すると、Drupal テーマを調整してカスタム モジュールを追加するため、高度にカスタマイズされたポータルを作成できます。

注: より高度な Drupal カスタマイズを実装するための学習曲線があります。ご希望の時間内でご希望のデザインを実現できるように、Drupal の専門知識を持つ第三者に協働してもらうことも検討してください。

以下は、Drupal を使用してポータルをカスタマイズするのに役立つリソースです。

パブリック クラウドのポータルにカスタムのモジュールとテーマを追加するにはどうすればよいですか？

独自のカスタムのモジュールとテーマを追加することで、ポータルの機能性を拡張できます。

カスタムのモジュールとテーマをクラウドベースのポータルに追加する場合は、ポータルの管理に Patheon か Acquia のどちらを使用しているかに応じて、次のセクションのいずれかを参照してください。

注: 変更できるのは /sites/all ディレクトリ内のコンテンツのみです。/sites/all ディレクトリの外部にあるコンテンツを変更すると、Git に変更をチェックインするときにマージ競合が発生する可能性があります。

カスタム モジュールの追加と更新に関するベスト プラクティスと詳細については、Drupal のドキュメントのモジュールとテーマの追加とモジュールの更新をそれぞれご覧ください。

プライベート クラウドのポータルにカスタムのモジュールとテーマを追加するにはどうすればよいですか？

独自のカスタムのモジュールとテーマを追加することで、ポータルの機能性を拡張できます。カスタム モジュールの追加と更新に関するベスト プラクティスと詳細については、Drupal のドキュメントのモジュールとテーマの追加とモジュールの更新をそれぞれご覧ください。

注: 変更できるのは /sites/all ディレクトリ内のコンテンツのみです。/sites/all ディレクトリの外部にあるコンテンツを変更すると、Git に変更をチェックインするときにマージ競合が発生する可能性があります。

ユーザーとアプリの登録をカスタマイズする

新規ユーザー登録ページをカスタマイズするにはどうすればよいですか？

ユーザーがポータルでアカウントを登録すると、ポータルには、[First Name]、[Last Name]、[Username]、[Email address]、[Password] の項目を含むデフォルトの登録ページが表示されます。API プロバイダはこのフォームを変更して、会社名やメールアドレスなどの追加情報の入力をユーザーに求めることができます。詳細については、以下をご覧ください。

アプリ登録ページをカスタマイズするにはどうすればよいですか？

デベロッパーがアプリを登録すると、ポータルにデフォルトのフォームが表示されます。API プロバイダは、このアプリ登録フォームを、デベロッパーにお客様 ID やアプリのターゲット プラットフォームなど、追加の情報の入力を促すように変更できます。関連ページ

デベロッパー ポータルでの認証に LDAP を使用するにはどうすればよいですか？

次のソースでは、LDAP を認証に使用する方法について説明します。

Apigee コミュニティ

Drupal のドキュメント

Twitter や Google、GitHub の認証情報を使用してポータルにログインするにはどうすればよいですか？

連携ログインとは、レコードのシステムと呼ばれる 1 つの ID 管理システムの認証情報を使用して、別のシステムにログインするプロセスです。たとえば、Google や Twitter の認証情報を使用して、Apigee デベロッパー ポータルにログインできます。ポータルでは、GitHub、Google、OpenID、Twitter などの一般的な複数のプロバイダからの認証情報を使用したフェデレーション ログインをサポートしています。詳細については、デベロッパー ポータルでの連携認証情報の使用をご覧ください。

手動の API キー承認のワークフローを適用するにはどうすればよいですか？

API プロダクトを作成するときに、アプリ登録用の手動 API キー承認を構成できます。この場合、アプリ デベロッパーがアプリを登録するときに API キーを手動で承認する必要があります。

手動での API キー承認のワークフローの適用に関する推奨事項については、コミュニティの What is the best way in dev portal to apply a workflow for manual API key approval? という記事をご覧ください。

バックアップ、リカバリ、高可用性

パブリック クラウドでポータルのバックアップや復元を行う方法を教えてください。

パブリック クラウドでポータルをバックアップする手順は、ポータルの管理に Patheon と Acquia のどちらを使用するかによって異なります。

プライベート クラウドでポータルのバックアップや復元を行う方法を教えてください。

Postgres の pg_dump コマンドと pg_restore コマンドを使用して、プライベート クラウド内のポータルをバックアップおよび復元します。詳細については、ポータルのバックアップをご覧ください。

パブリック クラウドのデベロッパー ポータルの高可用性を確保するにはどうすればよいですか？

Pantheon と Acquia の Drupal 管理ツールは、ホストするポータルの可用性を 99.5% 保証します。関連ページ

プライベート クラウドのデベロッパー ポータルの高可用性を確保するにはどうすればよいですか？

デベロッパー ポータルの高可用性を確保するための、「万能」なアプローチはありません。下記の専門知識を持つスタッフにサポートしてもらうことをおすすめします。

  • 高可用性構成でのファイル システムとデータベースの設定
  • Drupal 7 のポータル開発

サポートが必要な場合は、Apigee Customer Success チームにお問い合わせください。また、次のコミュニティ記事をご覧ください。

ポータルを保護する

ポータルのセキュリティを構成するにはどうすればよいですか？

Drupal には多くのセキュリティ機能が用意されています。このような機能はポータルの構築時に必要になります。詳細については、ポータルのセキュリティ保護をご覧ください。

TLS / HTTPS を使用する場合のポータルの構成方法を教えてください。

TLS（Transport Layer Security、前身は SSL）は、ウェブサーバーとウェブ クライアント（ブラウザやアプリなど）の間で暗号化されたリンクを確立するための標準的なセキュリティ テクノロジーです。暗号化されたリンクにより、サーバーとクライアントの間で送受信されるすべてのデータの機密性が確保されます。ポータルで TLS を構成する方法については、ポータルでの TLS の使用をご覧ください。

Drupal セキュリティ パッチの適用方法を教えてください。

Apigee Edge for Private Cloud のお客様の場合:

  • Pantheon: Apigee がポータルの新リリースを公開すると、メッセージが Pantheon ダッシュボードに表示されます。更新を定期的に確認して、セキュリティ アップデートをすみやかに適用する必要があります。詳細については、ポータルへの Apigee 更新の適用をご覧ください。
  • Acquia: Apigee は、定期的に、ポータル内のモジュールとテーマを自動的に最新のバージョンに更新します。更新は開発環境のみに行われ、他のポータル環境に移行する必要があることを示すタグが付けられます。詳細については、ポータルへのモジュールとテーマの更新の適用をご覧ください。

Apigee Edge for Private Cloud のお客様は、新しいバージョンの Drupal が利用可能である旨の通知を受け取ります。新しいバージョンとは、Drupal 機能リリース、パッチ、セキュリティ アップデート、その他の種類の Drupal アップデートを意味します。セキュリティ アップデートの場合は、サイトの安全性を維持するため、Drupal のインストールをすみやかにアップグレードしてください。詳細については、Drupal バージョンの Private Cloud インストールのアップグレードをご覧ください。

セキュリティ アップデートの登録方法を教えてください。

更新は、Drupal と Apigee の両方から登録します。

パブリック クラウドのお客様は、Drupal ウェブサイトのホストに登録することもできます。

  • Pantheon のユーザーは、http://status.getpantheon.com で Pantheon 固有のステータスの更新を受信するよう登録できます。登録するには、[Subscribe to Updates] をクリックします。
  • Acquia のユーザーは、ステータスの更新を受信するための登録で説明されているように、Acquia 固有のステータスの更新を受信するよう登録できます。

ユーザー名の列挙を防ぐにはどうすればよいですか？

ユーザー名の列挙とは、パスワードを忘れた場合のフォームを悪用して攻撃者がユーザー名を確認する方法です。デフォルトでは、このフォームを使用すると、指定したパスワードが存在するかどうか確認できます。攻撃者は、有効なユーザーが見つかるまでユーザー名を試し続けられます。ユーザー名の列挙を回避するには、ユーザー名の列挙防止モジュールをインストールします。

2 要素認証プロセスを有効にするにはどうすればよいですか？

Apigee デベロッパー ポータルを使用して API を公開する場合、2 要素認証プロセスを Apigee Edge で有効にしないでください。有効にしてしまうと、デベロッパー ポータルで Edge と通信できなくなります。

Edge 認証情報は Drupal ポータルでどのように保存され、暗号化されていますか？

次のソースでは、Edge 認証情報が Drupal ポータルでどのように保存され、暗号化されているかについて詳しく説明します。

Apigee コミュニティ:

コンテンツ アクセスを制御する

ポータルへのコンテンツ アクセスを制御するにはどうすればよいですか？

次のソースでは、ポータルへのコンテンツ アクセスを制御する方法について説明します。

Apigee コミュニティ:

Drupal のドキュメント:

API プロダクトへのアクセスをロール別に制御するにはどうすればよいですか？

次のソースでは、API プロダクトへのアクセスをロール別に制御する方法について説明します。

メールと通知を構成する

ポータルに SMTP メールサーバーを指定するにはどうすればよいですか？

デベロッパー ポータルでは、メール メッセージを送信する SMTP サーバーを構成する必要があります。SMTP サーバーを構成すると、デベロッパー ポータルで送信されるすべてのメールが SMTP サーバーを使用します。送信されるメールには、新しいデベロッパーに送信されるメール、パスワードを紛失したデベロッパーに送信されるメール、アカウントがブロックされたデベロッパーに送信されるメールなどがあります。詳細については、メールの構成をご覧ください。

デベロッパーがアプリを登録するとき（または他のイベントが発生したとき）にメールを送信するにはどうすればよいですか？

Drupal ルールを使用すると、特定のイベントにレスポンスしてポータルが実行するアクションを定義できます。ルールの一般的な使用法には、イベントへの応答時のメールの生成があります。ポータルには、新しいデベロッパーがアカウントを登録する場合など、事前定義されたイベントに対するメール生成のサポートが組み込まれていますが、独自のルールを追加してメールを生成することもできます。たとえば、デベロッパーがアプリを追加、削除、または変更した場合にメールを生成できます。詳細については、イベントが発生したときのメールの生成をご覧ください。

ポータルから送信されるメール メッセージのカスタマイズ方法を教えてください。

デベロッパー アカウントの登録、削除、ブロック、ブロックの解除など、特定のアクティビティに応答して送信されるさまざまなメール通知を構成できます。詳細については、メール通知の構成と書式設定をご覧ください。

ポータルに迷惑メールが来ないようにするにはどうすればよいですか？

ポータルに迷惑メールが来ないようにする方法の 1 つは、Drupal CAPTCHA と reCAPTCHA のモジュールを有効にして、CAPTCHA をログインページまたはその他のページに追加することです。詳細については、以下をご覧ください。

問題のトラブルシューティングを行う

ポータルのログファイルを表示するにはどうすればよいですか？

Drupal のメニューの [Reports] を選択すると、ログやその他のレポートのリストが表示されます。たとえば、[レポート] を選択すると、最新のログメッセージの表が表示されます。

動画: ログレポートとデバッグ設定について説明した短い動画をご覧ください。

コードにアクセスする

Drupal 7 デベロッパー ポータルのソースコードにアクセスするにはどうすればよいですか？

Pantheon または Acquia でホストされているサイトの場合は、次のセクションで説明するように、ホスティング サイトのダッシュボードから Drupal 7 デベロッパー ポータルのソースコードにアクセスできます。

Drupal 7 ソースコード リポジトリには、https://github.com/apigee/drupal7-drops から直接アクセスできます。Pantheon と Acquia のサイトでは、ソースコードの上流にこのリポジトリを使用しています。