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 開発とサーバー環境のベスト プラクティスをご覧ください。

パブリック クラウドのデベロッパー ポータルに 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 キー承認のワークフローの適用に関する推奨事項については、次のコミュニティの記事(手動の API キー承認のワークフローをデベロッパー ポータルに適用する最適な方法は何ですか?)をご覧ください。

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

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

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

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

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

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

Pantheon と Acquia の Drupal 管理ツールは、ホストするポータルの可用性を 99.5% 保証します。詳細については、以下をご覧ください。

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

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

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

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

ポータルを保護する

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

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 ウェブサイトのホストに登録することもできます。

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

ユーザー名の列挙とは、パスワードを忘れた場合のフォームがデフォルトで指定されたパスワードが存在するかどうかを示す特性を利用して、存在するユーザー名を特定する攻撃手法です。攻撃者は、有効なユーザーが見つかるまでユーザー名を試し続けられます。ユーザー名の列挙を防ぐには、Username Enumeration Prevention モジュールをインストールします。

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] を選択すると、ログやその他のレポートのリストが表示されます。たとえば、[Reports] > [Recent log messages] を選択すると、最新のログメッセージの表が表示されます。

動画: ログレポートとデバッグ設定の詳細については、こちらの動画をご覧ください。

コードにアクセスする

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

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

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