クイックスターターズ
NextJSのバックエンドを構築する方法は？

46min
はじめに
このチュートリアルでは、Back4appを使用して、NextJSアプリケーションの完全なバックエンドを構築する方法を学びます。
データベース管理、Cloud Code Functions、RESTおよびGraphQL API、ユーザー認証、リアルタイムクエリ（ライブクエリ）など、Back4appの重要な機能を統合する方法を説明し、NextJSフロントエンドとシームレスに通信する安全でスケーラブル、かつ堅牢なバックエンドを作成します。
また、Back4appの迅速なセットアップと直感的な環境が、サーバーやデータベースを手動で構成するのに比べて、時間と労力を大幅に削減できることを確認します。
その過程で、高度なセキュリティ機能、Cloud Jobsを使用したタスクのスケジューリング、外部統合のためのWebhookの設定など、主要な機能に関する実践的な経験を得ることができます。
このチュートリアルの終わりまでには、この基本的なセットアップを本番環境に適したアプリケーションに拡張する準備が整い、必要に応じてカスタムロジックやサードパーティAPIを簡単に組み込むことができるようになります。
前提条件
このチュートリアルを完了するには、次のものが必要です:
Back4appアカウントと新しいBack4appプロジェクト
 Back4appの始め方。
アカウントを持っていない場合は、無料で作成できます。上記のガイドに従ってプロジェクトを準備してください。
基本的なNextJS開発環境
 Create Next Appを使用して設定できます。マシンにNode.jsがインストールされていることを確認してください。
Node.js（バージョン14以上）がインストールされていること
npmパッケージをインストールし、ローカル開発サーバーを実行するためにNode.jsが必要です。 Node.jsのインストール﻿
JavaScriptと基本的なNextJSの概念に精通していること
 NextJS公式ドキュメント。﻿
始める前に、これらの前提条件がすべて整っていることを確認してください。Back4appプロジェクトを設定し、ローカルのNextJS環境を準備しておくと、より簡単に進めることができます。
ステップ1 – Back4appプロジェクトの設定
新しいプロジェクトを作成する
Back4app上でNextJSバックエンドを構築する最初のステップは、新しいプロジェクトを作成することです。まだ作成していない場合は、次の手順に従ってください:
Back4appアカウントにログインする.
ダッシュボードの「新しいアプリ」ボタンをクリックする.
アプリに名前を付ける（例：「NextJS-バックエンド-チュートリアル」）。
﻿
プロジェクトが作成されると、Back4appダッシュボードにリスト表示されます。このプロジェクトは、このチュートリアルで説明するすべてのバックエンド設定の基盤となります。
Parse SDKを接続する
Back4appは、データを管理し、リアルタイム機能を提供し、ユーザー認証を処理するためにParseプラットフォームに依存しています。NextJSアプリケーションをBack4appに接続するには、parse npmパッケージをインストールし、Back4appダッシュボードの資格情報で初期化します。
Parseキーを取得する:
Back4appダッシュボードで、アプリの「アプリ設定」または「セキュリティとキー」セクションに移動して、アプリケーションIDとJavaScriptキーを見つけます。また、ParseサーバーURL（通常はhttps://parseapi.back4app.comの形式）も見つけることができます。
﻿
NextJSプロジェクトにParse SDKをインストールする：
Bash
npm install parse
npm install parse
﻿
Yarnを使用している場合は、次のようにインストールできます:
Bash
yarn add parse
yarn add parse
﻿
NextJSアプリケーションでParseを初期化します：
NextJSプロジェクトでは、次のようなユーティリティファイル（例：parseConfig.js)を「lib」のようなフォルダーに作成できます。
lib/parseConfig.js
// lib/parseConfig.js
import Parse from 'parse';

// Replace the placeholders with your Back4app credentials
Parse.initialize('YOUR_APPLICATION_ID', 'YOUR_JAVASCRIPT_KEY');
Parse.serverURL = 'https://parseapi.back4app.com';

export default Parse;
// lib/parseConfig.js
import Parse from 'parse';

// Replace the placeholders with your Back4app credentials
Parse.initialize('YOUR_APPLICATION_ID', 'YOUR_JAVASCRIPT_KEY');
Parse.serverURL = 'https://parseapi.back4app.com';

export default Parse;
﻿
このファイルは、NextJSのページやAPIルートでParseをインポートするたびに、特定のBack4appインスタンスに接続するように事前設定されていることを保証します。
このステップを完了することで、NextJSのフロントエンドとBack4appのバックエンドの間に安全な接続が確立されました。すべてのリクエストとデータトランザクションは、このSDKを通じて安全にルーティングされ、手動のRESTまたはGraphQL呼び出しの複雑さが軽減されます（必要に応じてそれらを使用することもできます）。
ステップ2 – データベースの設定
データの保存とクエリ
Back4appプロジェクトが設定され、Parse SDKがNextJSアプリに統合されたので、データの保存と取得を開始できます。レコードを作成する最も簡単な方法は、「Parse.Object」クラスを使用することです。
JS
// Example: Create a Todo item

import Parse from '../lib/parseConfig';

async function createTodoItem(title, isCompleted) {
  const Todo = Parse.Object.extend('Todo');
  const todo = new Todo();
  todo.set('title', title);
  todo.set('isCompleted', isCompleted);

  try {
    const savedTodo = await todo.save();
    console.log('Todo saved successfully:', savedTodo);
    return savedTodo;
  } catch (error) {
    console.error('Error saving Todo:', error);
  }
}

// Example: Query all Todo items

async function fetchTodos() {
  const Todo = Parse.Object.extend('Todo');
  const query = new Parse.Query(Todo);

  try {
    const results = await query.find();
    console.log('Fetched Todo items:', results);
    return results;
  } catch (error) {
    console.error('Error fetching Todos:', error);
  }
}
// Example: Create a Todo item

import Parse from '../lib/parseConfig';

async function createTodoItem(title, isCompleted) {
  const Todo = Parse.Object.extend('Todo');
  const todo = new Todo();
  todo.set('title', title);
  todo.set('isCompleted', isCompleted);

  try {
    const savedTodo = await todo.save();
    console.log('Todo saved successfully:', savedTodo);
    return savedTodo;
  } catch (error) {
    console.error('Error saving Todo:', error);
  }
}

// Example: Query all Todo items

async function fetchTodos() {
  const Todo = Parse.Object.extend('Todo');
  const query = new Parse.Query(Todo);

  try {
    const results = await query.find();
    console.log('Fetched Todo items:', results);
    return results;
  } catch (error) {
    console.error('Error fetching Todos:', error);
  }
}
﻿
また、Back4appのREST APIエンドポイントを使用することもできます。
Curl
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APPLICATION_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Buy groceries", "isCompleted": false}' \
  https://parseapi.back4app.com/classes/Todo
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APPLICATION_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Buy groceries", "isCompleted": false}' \
  https://parseapi.back4app.com/classes/Todo
﻿
Back4appはGraphQLインターフェースも提供しています:
GraphQL
mutation {
  createTodo(input: {
    fields: {
      title: "Clean the house"
      isCompleted: false
    }
  }) {
    todo {
      objectId
      title
      isCompleted
    }
  }
}
mutation {
  createTodo(input: {
    fields: {
      title: "Clean the house"
      isCompleted: false
    }
  }) {
    todo {
      objectId
      title
      isCompleted
    }
  }
}
﻿
これらの多様なオプションにより、Parse SDK、REST、またはGraphQLを通じて、開発プロセスに最も適した方法でデータ操作を統合できます。
スキーマ設計とデータ型
デフォルトでは、Parseは スキーマを動的に作成する, しかし、より多くの制御のためにBack4appダッシュボードでクラスとデータ型を定義することもできます。
Back4appダッシュボードの「データベース」セクションに移動します。
新しいクラスを作成します。（例：「Todo」）そして、タイトル（String）やisCompleted（Boolean）などの関連するカラムを追加します。 
新しいクラスを作成
﻿
Back4appはさまざまなデータ型もサポートしています: String, Number, Boolean, Object, Date, File, Pointer, Array, Relation, GeoPoint, そして Polygon. 各フィールドに適切な型を選択できます。希望する場合は、NextJSアプリからオブジェクトを最初に保存するときにParseが自動的にこれらのカラムを作成することもできます。
カラムを作成
﻿
Back4appはデータモデルを設計するのに役立つAIエージェントを提供しています:
AIエージェントを開く あなたのアプリダッシュボードまたはメニューから。
データモデルを説明する 簡単な言葉で（例：「新しいToDoアプリをback4appで完全なクラススキーマで作成してください。」）。
AIエージェントにスキーマを作成させる. 
﻿
AIエージェントを使用すると、データアーキテクチャの設定にかかる時間を節約し、アプリケーション全体での一貫性を確保できます。
リレーショナルデータ
リレーショナルデータがある場合—たとえば、複数のCategoryオブジェクトが複数のTodoアイテムを指している場合—ParseでPointersまたはRelationsを使用できます。たとえば、Categoryへのポインタを追加することができます:
JS
// Linking a Task to a Category with a pointer
async function createTaskForCategory(categoryObjectId, title) {
  const todo = new Parse.Object('Todo');

  // Construct a pointer to the category
  const categoryPointer = new Parse.Object('Category');
  categoryPointer.id = categoryObjectId;

  // Set fields
  todo.set('title', title);
  todo.set('category', categoryPointer);

  try {
    return await todo.save();
  } catch (err) {
    console.error('Error creating Task with category relationship:', err);
  }
}
// Linking a Task to a Category with a pointer
async function createTaskForCategory(categoryObjectId, title) {
  const todo = new Parse.Object('Todo');

  // Construct a pointer to the category
  const categoryPointer = new Parse.Object('Category');
  categoryPointer.id = categoryObjectId;

  // Set fields
  todo.set('title', title);
  todo.set('category', categoryPointer);

  try {
    return await todo.save();
  } catch (err) {
    console.error('Error creating Task with category relationship:', err);
  }
}
﻿
クエリを実行する際には、ポインタデータも含めることができます:
JS
const query = new Parse.Query('Todo');
query.include('category');
const todosWithCategory = await query.find();
const query = new Parse.Query('Todo');
query.include('category');
const todosWithCategory = await query.find();
﻿
このinclude('category')呼び出しは、各Todoとともにカテゴリの詳細を取得し、リレーショナルデータをシームレスにアクセス可能にします。
ライブクエリ
リアルタイムの更新のために、Back4appはライブクエリを提供します。あなたのNextJSアプリでは、特定のクラスの変更にサブスクライブできます:
ライブクエリを有効にする あなたのBack4appダッシュボードのアプリの サーバー設定. “ライブクエリ”がオンになっていることを確認してください。
ライブクエリサブスクリプションを初期化する あなたのコードで:
lib/parseConfig.js
// lib/parseConfig.js
import Parse from 'parse';

// Replace the placeholders with your Back4app credentials
Parse.initialize('YOUR_APPLICATION_ID', 'YOUR_JAVASCRIPT_KEY');
Parse.serverURL = 'https://parseapi.back4app.com';

// Live Query's subdomain:
Parse.liveQueryServerURL = 'wss://YOUR_SUBDOMAIN_HERE.b4a.io';

export default Parse;
// lib/parseConfig.js
import Parse from 'parse';

// Replace the placeholders with your Back4app credentials
Parse.initialize('YOUR_APPLICATION_ID', 'YOUR_JAVASCRIPT_KEY');
Parse.serverURL = 'https://parseapi.back4app.com';

// Live Query's subdomain:
Parse.liveQueryServerURL = 'wss://YOUR_SUBDOMAIN_HERE.b4a.io';

export default Parse;
﻿
JS
import Parse from '../lib/parseConfig';

async function subscribeToTodos(callback) {
  const query = new Parse.Query('Todo');
  const subscription = await query.subscribe();

  subscription.on('create', (newTodo) => {
    console.log('New Todo created:', newTodo);
    callback('create', newTodo);
  });

  subscription.on('update', (updatedTodo) => {
    console.log('Todo updated:', updatedTodo);
    callback('update', updatedTodo);
  });

  subscription.on('delete', (deletedTodo) => {
    console.log('Todo deleted:', deletedTodo);
    callback('delete', deletedTodo);
  });

  return subscription;
}
import Parse from '../lib/parseConfig';

async function subscribeToTodos(callback) {
  const query = new Parse.Query('Todo');
  const subscription = await query.subscribe();

  subscription.on('create', (newTodo) => {
    console.log('New Todo created:', newTodo);
    callback('create', newTodo);
  });

  subscription.on('update', (updatedTodo) => {
    console.log('Todo updated:', updatedTodo);
    callback('update', updatedTodo);
  });

  subscription.on('delete', (deletedTodo) => {
    console.log('Todo deleted:', deletedTodo);
    callback('delete', deletedTodo);
  });

  return subscription;
}
﻿
サブスクリプションを行うことで、新しいTodoが作成、更新、または削除されるたびにリアルタイム通知を受け取ります。この機能は、複数のユーザーがページをリフレッシュせずに最新のデータを確認する必要があるコラボレーティブまたはダイナミックなアプリに特に価値があります。
ステップ3 – ACLとCLPを使用したセキュリティの適用
Back4appのセキュリティメカニズム
Back4appは、アクセス制御リスト (ACL)とクラスレベルの権限 (CLP)を提供することで、セキュリティを真剣に考えています。これらの機能により、オブジェクトまたはクラスごとにデータの読み取りや書き込みを制限でき、認可されたユーザーのみがデータを変更できるようになります。
﻿
アクセス制御リスト (ACL)
ACLは、個々のオブジェクトに適用され、どのユーザー、役割、または一般の人々が読み取り/書き込み操作を行えるかを決定します。例えば:
JS
async function createPrivateTodo(title, ownerUser) {
  const Todo = Parse.Object.extend('Todo');
  const todo = new Todo();
  todo.set('title', title);

  // Create an ACL granting read/write access only to the owner
  const acl = new Parse.ACL(ownerUser);
  acl.setPublicReadAccess(false);
  acl.setPublicWriteAccess(false);

  todo.setACL(acl);

  try {
    return await todo.save();
  } catch (err) {
    console.error('Error saving private todo:', err);
  }
}
async function createPrivateTodo(title, ownerUser) {
  const Todo = Parse.Object.extend('Todo');
  const todo = new Todo();
  todo.set('title', title);

  // Create an ACL granting read/write access only to the owner
  const acl = new Parse.ACL(ownerUser);
  acl.setPublicReadAccess(false);
  acl.setPublicWriteAccess(false);

  todo.setACL(acl);

  try {
    return await todo.save();
  } catch (err) {
    console.error('Error saving private todo:', err);
  }
}
﻿
オブジェクトを保存すると、それには指定されたユーザー以外の誰も読み取りまたは変更できないようにするACLがあります。
ACLを編集
﻿
クラスレベルの権限 (CLP)
CLPは、クラス全体のデフォルトの権限を管理します。たとえば、クラスが公開されているか書き込み可能か、または特定の役割のみがアクセスできるかどうかです。
Back4appダッシュボードに移動, アプリを選択し、データベースセクションを開きます。
クラスを選択（例：「Todo」）。
クラスレベルの権限タブを開きます。 
「認証が必要」などのデフォルトを設定します。読み取りまたは書き込み用、または「公開にアクセス不可」。
﻿
これらの権限はベースラインを設定し、ACLは個々のオブジェクトの権限を微調整します。堅牢なセキュリティモデルは通常、CLP（広範な制限）とACL（オブジェクトごとの細かい制限）を組み合わせます。詳細については、アプリセキュリティガイドライン。﻿
ステップ4 – クラウド関数の作成とデプロイ
クラウドコードは、Parse Server環境の機能で、サーバー側でカスタムJavaScriptコードを実行できるようにします。サーバーやインフラストラクチャを管理する必要はありません。クラウドコードを書くことで、Back4appバックエンドを追加のビジネスロジック、バリデーション、トリガー、および安全かつ効率的にParse Server上で実行される統合で拡張できます。
動作の仕組み
クラウドコードを書くときは、通常、JavaScript関数、トリガー、および必要なNPMモジュールをmain.js（またはapp.js)ファイルに配置します。このファイルはBack4appプロジェクトにデプロイされ、Parse Server環境内で実行されます。これらの関数とトリガーはサーバー上で実行されるため、機密ロジックを処理したり、敏感なデータを処理したり、バックエンド専用のAPI呼び出しを行ったりすることを信頼できます。これらのプロセスは、クライアントに直接公開したくないかもしれません。
あなたのBack4appアプリのすべてのCloud Codeは、Back4appによって管理されているParse Server内で実行されるため、サーバーのメンテナンス、スケーリング、またはプロビジョニングについて心配する必要はありません。あなたが main.js ファイルを更新してデプロイするたびに、実行中のParse Serverは最新のコードで更新されます。
main.jsファイル構造
典型的な main.js には次のような内容が含まれる場合があります:
必要なモジュールのための ステートメント（NPMパッケージ、組み込みNodeモジュール、または他のクラウドコードファイル）。
Cloud関数の定義 を使用して Parse.Cloud.define().
トリガー 例えば Parse.Cloud.beforeSave(), Parse.Cloud.afterSave(), など。
インストールしたNPMモジュール（必要な場合）。例えば、HTTPリクエストを行うために axios のようなパッケージをインストールすることがあります。その後、ファイルの先頭でそれをrequire（またはimport）できます。
JS
// main.js

// 1. Import necessary modules and other cloud code files
const axios = require('axios');
const report = require('./reports');

// 2. Define a custom Cloud Function
Parse.Cloud.define('fetchExternalData', async (request) => {
  const url = request.params.url;
  if (!url) {
    throw new Error('URL parameter is required');
  }
  const response = await axios.get(url);
  return response.data;
});

// 3. Example of a beforeSave trigger
Parse.Cloud.beforeSave('Todo', (request) => {
  const todo = request.object;
  if (!todo.get('title')) {
    throw new Error('Todo must have a title');
  }
});
// main.js

// 1. Import necessary modules and other cloud code files
const axios = require('axios');
const report = require('./reports');

// 2. Define a custom Cloud Function
Parse.Cloud.define('fetchExternalData', async (request) => {
  const url = request.params.url;
  if (!url) {
    throw new Error('URL parameter is required');
  }
  const response = await axios.get(url);
  return response.data;
});

// 3. Example of a beforeSave trigger
Parse.Cloud.beforeSave('Todo', (request) => {
  const todo = request.object;
  if (!todo.get('title')) {
    throw new Error('Todo must have a title');
  }
});
﻿
NPMモジュールをインストールして使用する能力により、Cloud Codeは非常に柔軟になり、外部APIとの統合、データ変換の実行、または複雑なサーバーサイドロジックの実行が可能になります。
典型的な使用例
ビジネスロジック: 例えば、複数のオブジェクトプロパティを集計してゲーム内のユーザーのスコアを計算し、そのデータを自動的に保存することができます。
データ検証: レコードを保存または削除する前に、特定のフィールドが存在することやユーザーが正しい権限を持っていることを確認します。
トリガー: データが変更されたときにアクションを実行します（例：ユーザーがプロフィールを更新したときに通知を送信）。
統合: サードパーティのAPIやサービスと接続します。例えば、Cloud Codeから直接、決済ゲートウェイ、Slack通知、またはメールマーケティングプラットフォームと統合することができます。
セキュリティの強化: Cloud Code関数内で入力パラメータを検証およびサニタイズすることで、追加のセキュリティ層を追加します。例えば、受信データが特定の形式に一致することを確認し、無効または悪意のある入力を拒否し、機密操作を実行する前にユーザーの役割や権限に基づいてアクセスルールを強制することができます。
関数をデプロイする
以下は、クライアントから送信されたテキスト文字列の長さを計算するシンプルなCloud Code関数です。
main.js
// main.js

Parse.Cloud.define('calculateTextLength', async (request) => {
  const { text } = request.params;
  if (!text) {
    throw new Error('No text provided');
  }
  return { length: text.length };
});
// main.js

Parse.Cloud.define('calculateTextLength', async (request) => {
  const { text } = request.params;
  if (!text) {
    throw new Error('No text provided');
  }
  return { length: text.length };
});
﻿
デプロイするには Back4app CLI:
1 - CLIをインストールする：
Linux/MacOSの場合:
Bash
curl https://raw.githubusercontent.com/back4app/parse-cli/back4app/installer.sh | sudo /bin/bash
curl https://raw.githubusercontent.com/back4app/parse-cli/back4app/installer.sh | sudo /bin/bash
﻿
Windowsの場合:
 b4a.exeファイルをリリースページからダウンロードします。
2 - アカウントキーを設定する:
Bash
b4a configure accountkey
b4a configure accountkey
﻿
3 - クラウドコードをデプロイする：
Bash
b4a deploy
b4a deploy
﻿
ダッシュボードを通じてデプロイする:
アプリのダッシュボードで、クラウドコード > 関数に移動します。
関数をmain.jsエディタにコピー/ペーストします。
「デプロイ」をクリックします。
﻿
関数の呼び出し
Parse SDKを使用してNextJS環境から（例えば、APIルートやページで）:
JS
import Parse from '../../lib/parseConfig';

export default async function handler(req, res) {
  if (req.method === 'POST') {
    try {
      const text = req.body.text || '';
      const result = await Parse.Cloud.run('calculateTextLength', { text });
      return res.status(200).json(result);
    } catch (err) {
      console.error('Error calling cloud function:', err);
      return res.status(500).json({ error: 'Something went wrong' });
    }
  } else {
    return res.status(405).json({ error: 'Method not allowed' });
  }
}
import Parse from '../../lib/parseConfig';

export default async function handler(req, res) {
  if (req.method === 'POST') {
    try {
      const text = req.body.text || '';
      const result = await Parse.Cloud.run('calculateTextLength', { text });
      return res.status(200).json(result);
    } catch (err) {
      console.error('Error calling cloud function:', err);
      return res.status(500).json({ error: 'Something went wrong' });
    }
  } else {
    return res.status(405).json({ error: 'Method not allowed' });
  }
}
﻿
REST経由でも呼び出すことができます:
Curl
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello Back4app"}' \
  https://parseapi.back4app.com/functions/calculateTextLength
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello Back4app"}' \
  https://parseapi.back4app.com/functions/calculateTextLength
﻿
またはGraphQL経由で:
GraphQL
mutation {
  calculateTextLength(input: {
    text: "Hello GraphQL"
  }) {
    result
  }
}
mutation {
  calculateTextLength(input: {
    text: "Hello GraphQL"
  }) {
    result
  }
}
﻿
この柔軟性により、NextJSフロントエンドやRESTまたはGraphQLをサポートする他のクライアントにカスタムロジックを統合することができます。
ステップ5 – ユーザー認証の設定
Back4appにおけるユーザー認証
Back4appは、Parse Userクラスを認証の基盤として活用しています。デフォルトでは、Parseはパスワードのハッシュ化、セッショントークン、セキュアストレージを処理します。これにより、複雑なセキュリティフローを手動で設定する必要がありません。
ユーザー認証の設定
NextJSでは、新しいユーザーを次のように作成できます:
JS
import Parse from '../../lib/parseConfig';

export async function signUpUser(username, password, email) {
  const user = new Parse.User();
  user.set('username', username);
  user.set('password', password);
  user.set('email', email);

  try {
    await user.signUp();
    console.log('User signed up successfully!');
    return user;
  } catch (error) {
    console.error('Error signing up user:', error);
    throw error;
  }
}

export async function logInUser(username, password) {
  try {
    const user = await Parse.User.logIn(username, password);
    console.log('User logged in:', user);
    return user;
  } catch (error) {
    console.error('Error logging in user:', error);
    throw error;
  }
}
import Parse from '../../lib/parseConfig';

export async function signUpUser(username, password, email) {
  const user = new Parse.User();
  user.set('username', username);
  user.set('password', password);
  user.set('email', email);

  try {
    await user.signUp();
    console.log('User signed up successfully!');
    return user;
  } catch (error) {
    console.error('Error signing up user:', error);
    throw error;
  }
}

export async function logInUser(username, password) {
  try {
    const user = await Parse.User.logIn(username, password);
    console.log('User logged in:', user);
    return user;
  } catch (error) {
    console.error('Error logging in user:', error);
    throw error;
  }
}
﻿
REST経由でのログインは次のようになります:
Bash
curl -X GET \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -G \
  --data-urlencode 'username=alice' \
  --data-urlencode 'password=secret123' \
  https://parseapi.back4app.com/login
curl -X GET \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -G \
  --data-urlencode 'username=alice' \
  --data-urlencode 'password=secret123' \
  https://parseapi.back4app.com/login
﻿
セッション管理
成功したログインの後、Parseはセッショントークンをユーザーオブジェクトに保存します。NextJSで現在ログインしているユーザーを次のように取得できます（例：APIルート内）:
JS
const currentUser = Parse.User.current();
if (currentUser) {
  console.log('Currently logged-in user:', currentUser.getUsername());
} else {
  console.log('No user is logged in');
}
const currentUser = Parse.User.current();
if (currentUser) {
  console.log('Currently logged-in user:', currentUser.getUsername());
} else {
  console.log('No user is logged in');
}
﻿
Parseはバックグラウンドでトークンベースのセッションを自動的に処理しますが、手動で管理または取り消すこともできます。これは、ログアウトする必要があるときに便利です:
JS
await Parse.User.logOut();
await Parse.User.logOut();
﻿
ソーシャルログイン統合
Back4appとParseは、追加のパッケージをインストールするか、既存のアダプターを使用することで、GoogleやFacebookなどの人気のあるOAuthプロバイダーと統合できます。たとえば、Facebook App IDを設定し、Parse.FacebookUtils.logIn()を使用することで、Facebookログインを設定できます。詳細な手順は異なるため、ソーシャルログインドキュメント。﻿
JS
const facebookLogin = async () => {
  try {
    const user = await Parse.FacebookUtils.logIn('email');
    console.log(user.existed() ? 'User logged in' : 'User signed up and logged in');
  } catch (error) {
    console.error('Error logging in with Facebook:', error);
  }
};
const facebookLogin = async () => {
  try {
    const user = await Parse.FacebookUtils.logIn('email');
    console.log(user.existed() ? 'User logged in' : 'User signed up and logged in');
  } catch (error) {
    console.error('Error logging in with Facebook:', error);
  }
};
﻿
メール認証とパスワードリセット
メール認証とパスワードリセットを有効にするには:
メール設定に移動します。
メール認証を有効にすることで、新しいユーザーが自分のメールアドレスの所有権を確認できるようにします。
送信元アドレスを設定する, メールテンプレート、および必要に応じてカスタムドメインを設定します。
これらの機能は、ユーザーのメールの所有権を検証し、安全なパスワード回復方法を提供することで、アカウントのセキュリティとユーザーエクスペリエンスを向上させます。
ステップ6 – ファイルストレージの取り扱い
ファイルのアップロードと取得
Parseには、ファイルのアップロードを処理するためのParse.Fileクラスが含まれており、Back4appが安全に保存します:
JS
import Parse from '../../lib/parseConfig';

async function uploadImage(file) {
  // file could come from a <input type="file" ...> in a NextJS page
  const name = file.name;
  const parseFile = new Parse.File(name, file);

  try {
    const savedFile = await parseFile.save();
    console.log('File saved:', savedFile.url());
    return savedFile.url();
  } catch (err) {
    console.error('Error uploading file:', err);
    throw err;
  }
}
import Parse from '../../lib/parseConfig';

async function uploadImage(file) {
  // file could come from a <input type="file" ...> in a NextJS page
  const name = file.name;
  const parseFile = new Parse.File(name, file);

  try {
    const savedFile = await parseFile.save();
    console.log('File saved:', savedFile.url());
    return savedFile.url();
  } catch (err) {
    console.error('Error uploading file:', err);
    throw err;
  }
}
﻿
データベース内のオブジェクトにファイルを添付するには、次のようにします:
JS
async function createPhotoObject(file) {
  const Photo = Parse.Object.extend('Photo');
  const photo = new Photo();
  const parseFile = new Parse.File(file.name, file);
  photo.set('imageFile', parseFile);

  return await photo.save();
}
async function createPhotoObject(file) {
  const Photo = Parse.Object.extend('Photo');
  const photo = new Photo();
  const parseFile = new Parse.File(file.name, file);
  photo.set('imageFile', parseFile);

  return await photo.save();
}
﻿
ファイルのURLを取得するのは簡単です:
JS
const imageFile = photo.get('imageFile');
const imageUrl = imageFile.url();
const imageFile = photo.get('imageFile');
const imageUrl = imageFile.url();
﻿
このimageUrlをNextJSコンポーネントで表示するには、srcを設定して、<img>タグにします。
ファイルのセキュリティ
Parse Serverは、ファイルアップロードのセキュリティを管理するための柔軟な設定を提供します。以下の例は、誰がサーバーにファイルをアップロードできるかを制御するための権限を設定する方法を示しています:
JSON
{
    "fileUpload": {
        "enableForPublic": true,
        "enableForAnonymousUser": true,
        "enableForAuthenticatedUser": true
    }
}
{
    "fileUpload": {
        "enableForPublic": true,
        "enableForAnonymousUser": true,
        "enableForAuthenticatedUser": true
    }
}
﻿
enableForPublic: trueに設定すると、認証状態に関係なく、誰でもファイルをアップロードできます。
enableForAnonymousUser: 匿名ユーザー（サインアップしていないユーザー）がファイルをアップロードできるかどうかを制御します。有効にすると、一時的またはゲストユーザーがファイルをアップロードできます。
enableForAuthenticatedUser: 認証されたユーザーのみがファイルをアップロードできるかどうかを指定します。これは、信頼できるユーザーのみがこの機能にアクセスできるようにするために理想的です。
ステップ7 – クラウドジョブによるタスクのスケジューリング
クラウドジョブ
クラウドジョブはBack4appでバックエンド上でルーチン作業をスケジュールして実行できます。例えば、古いデータのクリーンアップや毎日の要約メールの送信などです。典型的なクラウドジョブは次のようになります:
JS
// main.js

Parse.Cloud.job('cleanupOldTodos', async (request) => {
  // This runs in the background, not triggered by a direct user request
  const Todo = Parse.Object.extend('Todo');
  const query = new Parse.Query(Todo);

  // For example, remove todos older than 30 days
  const now = new Date();
  const THIRTY_DAYS = 30 * 24 * 60 * 60 * 1000;
  const cutoff = new Date(now - THIRTY_DAYS);

  query.lessThan('createdAt', cutoff);

  try {
    const oldTodos = await query.find({ useMasterKey: true });
    await Parse.Object.destroyAll(oldTodos, { useMasterKey: true });
    return `Deleted ${oldTodos.length} old Todos.`;
  } catch (err) {
    throw new Error('Error during cleanup:' + err.message);
  }
});
// main.js

Parse.Cloud.job('cleanupOldTodos', async (request) => {
  // This runs in the background, not triggered by a direct user request
  const Todo = Parse.Object.extend('Todo');
  const query = new Parse.Query(Todo);

  // For example, remove todos older than 30 days
  const now = new Date();
  const THIRTY_DAYS = 30 * 24 * 60 * 60 * 1000;
  const cutoff = new Date(now - THIRTY_DAYS);

  query.lessThan('createdAt', cutoff);

  try {
    const oldTodos = await query.find({ useMasterKey: true });
    await Parse.Object.destroyAll(oldTodos, { useMasterKey: true });
    return `Deleted ${oldTodos.length} old Todos.`;
  } catch (err) {
    throw new Error('Error during cleanup:' + err.message);
  }
});
﻿
クラウドコードをデプロイする 新しいジョブと共に（CLIまたはダッシュボード経由で）。
Back4appダッシュボードに移動する > アプリ設定 > サーバー設定 > バックグラウンドジョブ. 
ジョブをスケジュールする 毎日またはニーズに合った間隔で実行されるように。
クラウドジョブのスケジューリング
﻿
クラウドジョブは、手動の介入なしでバックグラウンドメンテナンスやその他の定期的なプロセスを自動化することを可能にします。
ステップ8 – ウェブフックの統合
Webhooks は、特定のイベントが発生するたびに、Back4appアプリが外部サービスにHTTPリクエストを送信できるようにします。これは、決済ゲートウェイ（例：Stripe）、メールマーケティングツール、または分析プラットフォームなどのサードパーティシステムと統合するために強力です。
Webhooks設定に移動 あなたのBack4appダッシュボード > その他 > WebHooksに行き、次に「Webhookを追加」をクリックします。
エンドポイントを設定 （例：https://your-external-service.com/webhook-endpoint）。
トリガーを設定 して、Back4appのクラスやCloud Code関数でどのイベントがWebhookを発火させるかを指定します。
Webhookの追加
﻿
例えば、新しいTodoが作成されるたびにSlackチャンネルに通知したい場合:
受信Webhookを受け入れるSlackアプリを作成します。
SlackのWebhook URLをコピーします。
Back4appダッシュボードで、「Todoクラスの新しいレコード」というイベントのために、そのSlack URLにエンドポイントを設定します。
必要に応じて、カスタムHTTPヘッダーやペイロードを追加することもできます。
Cloud CodeでWebhooksを定義することもできます。beforeSaveやafterSaveのトリガーでカスタムHTTPリクエストを作成します:
BeforeSave WebHook
﻿
ステップ9 – Back4app管理パネルの探索
「Back4app Admin App」は、非技術的なユーザーがCRUD操作を実行し、コードを書くことなく日常的なデータタスクを処理するために設計されたウェブベースの管理インターフェースです。これは、データベース管理、カスタムデータ管理、エンタープライズレベルの操作を効率化するモデル中心, ユーザーフレンドリーなインターフェースを提供します。
管理アプリの有効化
「有効化」を選択し、App Dashboard > More > Admin Appに移動して、「管理アプリを有効化」ボタンをクリックします。
管理アプリを有効化
﻿
最初の管理ユーザーを作成します（ユーザー名/パスワード）。これにより、新しい役割（B4aAdminUser）とクラス（B4aSetting、B4aMenuItem、B4aCustomField）がアプリのスキーマに自動的に生成されます。
﻿
管理インターフェースにアクセスするためのサブドメインを選択し、セットアップを完了します。
﻿
ログイン して、新しい管理アプリのダッシュボードにアクセスするために作成した管理者資格情報を使用してください。
﻿
有効にすると、Back4app管理アプリを使用すると、Parseダッシュボードやバックエンドコードを直接使用することなく、データベースのレコードを簡単に表示、編集、または削除できます。設定可能なアクセス制御を使用することで、データを管理するための明確でポイントアンドクリックの方法が必要なチームメンバーやクライアントとこのインターフェースを安全に共有できます。
結論
この包括的なチュートリアルに従うことで、あなたは:
安全なバックエンドを作成しました Back4app上のNextJSアプリ用。
データベースを構成しました クラススキーマ、データ型、関係を使用して。
リアルタイムクエリを統合しました （ライブクエリ）即時データ更新のため。
セキュリティ対策を適用しました ACLとCLPを使用してデータアクセスを保護および管理。
クラウドコードを実装しました サーバー側でカスタムビジネスロジックを実行するための関数。
ユーザー認証を設定しました メール確認とパスワードリセットをサポート。
ファイルのアップロードを管理しました オプションのファイルセキュリティコントロール付き。
クラウドジョブをスケジュールしました 自動バックグラウンドタスクのため。
Webhookを使用しました 外部サービスと統合するため。
Back4app管理パネルを探索しました データ管理のため。
堅牢なNextJSフロントエンドと強力なBack4appバックエンドを持つことで、機能豊富でスケーラブルかつ安全なアプリケーションを開発するための準備が整いました。より高度な機能を探求し、ビジネスロジックを統合し、Back4appの力を活用してサーバーとデータベースの管理にかかる無数の時間を節約してください。コーディングを楽しんでください！
次のステップ
本番環境に適したNextJSアプリを構築する このバックエンドを拡張して、より複雑なデータモデル、キャッシング戦略、パフォーマンス最適化を処理します。
高度な機能を統合する 特化した認証フロー、役割ベースのアクセス制御、または外部API（支払いゲートウェイなど）を含みます。
Back4appの公式ドキュメントをチェックする 高度なセキュリティ、パフォーマンス調整、ログ分析についての詳細な情報を得るために。
他のチュートリアルを探る リアルタイムチャットアプリケーション、IoTダッシュボード、または位置情報サービスに関するものです。ここで学んだ技術をサードパーティのAPIと組み合わせて、複雑な実世界のアプリケーションを作成できます。
﻿
更新日 24 Jan 2025
このページは役に立ちましたか？
NodeJSのバックエンドを構築する方法は？
AngularJSのバックエンドを構築する方法は？