Quickstarters
Comment construire un backend pour ASP.NET Core ?

34min
Introduction
Dans ce tutoriel, vous apprendrez à construire un backend pour ASP.NET Core en utilisant Back4App. 
En intégrant les fonctionnalités essentielles de Back4App—telles que la gestion de base de données, le Cloud Code, les API REST et GraphQL, l'authentification des utilisateurs et les requêtes en temps réel—vous obtiendrez une solution backend complète pour vos applications ASP.NET Core. 
Cette approche permet de construire des applications web évolutives, en gérant la logique côté serveur avec un minimum de configuration.
Avec Back4App, vous pouvez accélérer le développement backend de votre projet ASP.NET Core. Vous bénéficierez d'une plateforme open source qui prend en charge une infrastructure d'API web fiable, la connectivité de base de données et des fonctions cloud robustes. 
À la fin de ce tutoriel, vous aurez une base fonctionnelle pour un backend sécurisé et extensible qui offre une meilleure expérience utilisateur et gère les données en temps réel. Vous pourrez ensuite étendre votre solution .NET Core ou l'intégrer à d'autres services selon vos besoins.
Prérequis
Un compte Back4App et un nouveau projet Back4App
Commencer avec Back4app.
Si vous n'avez pas de compte, vous pouvez en créer un gratuitement.
Environnement de développement ASP.NET Core
Assurez-vous d'avoir le SDK .NET (version 6.0 ou supérieure) installé. Télécharger .NET﻿
Familiarité avec C# et ASP.NET Core
Documentation officielle d'ASP.NET Core.﻿
Optionnel: Si vous prévoyez d'utiliser le SDK .NET de Parse, vous aurez besoin de Parse-SDK-dotNET ou de références dans votre fichier .csproj.
Assurez-vous d'avoir tous ces prérequis en place avant de commencer. Avoir votre projet Back4App et un environnement ASP.NET Core prêt facilitera beaucoup les étapes à suivre.
Étape 1 – Création d'un nouveau projet sur Back4App et connexion
Pourquoi cette étape ?
Votre backend ASP.NET Core commence avec un projet Back4App. Ce projet est votre fondation côté serveur, gérant votre base de données, vos règles de sécurité et les paramètres de l'application.
Création du projet
Connectez-vous à votre compte Back4App.
Cliquez sur “Nouvelle application” depuis votre tableau de bord.
Nommez votre application (par exemple, “AspNetCore-Backend-Tutorial”).
﻿
Après la création, vous le verrez listé sur votre tableau de bord. Cette nouvelle application est votre principal hub pour le développement backend tâches.
Installation du SDK Parse .NET (Optionnel)
Bien que vous puissiez utiliser l'API REST ou GraphQL directement, le SDK Parse .NET peut simplifier les opérations de données dans vos solutions ASP.NET Core . Si vous souhaitez l'intégrer :
Ajoutez le SDK Parse à votre .csproj ou via le gestionnaire de packages NuGet :
Initialisez le SDK dans votre application ASP.NET Core (par exemple, Program.cs ou Startup.cs) :
Remplacez les espaces réservés par les identifiants de votre application Back4App dans “Paramètres de l'application” > “Sécurité et clés.” Cela connecte votre projet asp.net core à l'environnement côté serveur de Back4App.
Étape 2 – Configuration de la base de données
1. Création d'un modèle de données
Utilisez le tableau de bord Back4App pour définir votre schéma de classe. Par exemple, une classe Todo avec des colonnes comme titre (String) et estComplété (Boolean) :
Créer une nouvelle classe
﻿
2. Création d'un modèle de données à l'aide de l'agent IA
Ouvrez l'agent IA dans votre tableau de bord Back4App et décrivez votre modèle de données. Par exemple, “Créez une nouvelle classe ToDo pour mes applications asp.net core.” L'agent IA configure alors le schéma pour vous.
﻿
3. Lecture et écriture de données en utilisant le SDK .NET de Parse
Voici comment vous pourriez créer et récupérer des Todo éléments en C# :
C#
using Parse;

// Create a new Todo
public async Task<ParseObject> CreateTodo(string title, bool isCompleted)
{
    var todo = new ParseObject("Todo")
    {
        { "title", title },
        { "isCompleted", isCompleted }
    };

    return await todo.SaveAsync();
}

// Fetch all Todos
public async Task<IEnumerable<ParseObject>> FetchTodos()
{
    var query = new ParseQuery<ParseObject>("Todo");
    return await query.FindAsync();
}
using Parse;

// Create a new Todo
public async Task<ParseObject> CreateTodo(string title, bool isCompleted)
{
    var todo = new ParseObject("Todo")
    {
        { "title", title },
        { "isCompleted", isCompleted }
    };

    return await todo.SaveAsync();
}

// Fetch all Todos
public async Task<IEnumerable<ParseObject>> FetchTodos()
{
    var query = new ParseQuery<ParseObject>("Todo");
    return await query.FindAsync();
}
﻿
4. Lecture et écriture de données en utilisant l'API REST
Alternativement, vous pouvez utiliser une API REST approche :
Bash
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
﻿
5. Lecture et écriture de données en utilisant l'API GraphQL
Pour utiliser GraphQL, envoyez des requêtes ou des mutations à l'endpoint GraphQL de Back4App :
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
    }
  }
}
﻿
6. Travailler avec des requêtes en temps réel
Activez des mises à jour en temps réel en activant les requêtes en direct dans votre tableau de bord (sous Paramètres du serveur). Ensuite, utilisez l'approche .NET ou WebSocket pour vous abonner. Cela maintient les données à jour dans votre application web sans appels supplémentaires.
Étape 3 – Appliquer la sécurité avec les ACL et les CLP
Aperçu des ACL et des CLP
Les ACL (Listes de Contrôle d'Accès) sécurisent des objets individuels. Les CLP (Permissions au Niveau de la Classe) sécurisent des classes entières. Cette approche en couches garde les données en sécurité dans votre environnement asp.net core.
﻿
Configuration des Permissions au Niveau de la Classe
Ouvrez l'onglet Base de données dans votre tableau de bord Back4App.
Sélectionnez la classe Todo.
Cliquez sur Permissions au Niveau de la Classe.
Personnalisez la lecture/écriture pour les rôles publics ou authentifiés.
Configuration des ACL dans le Code
Avec le SDK .NET de Parse, vous pouvez définir des ACL au niveau des objets :
C#
var todo = new ParseObject("Todo")
{
    { "title", "Private Task" }
};

// Restrict read/write to only a particular user
var acl = new ParseACL();
acl.SetPublicReadAccess(false);
acl.SetPublicWriteAccess(false);
acl.SetReadAccess(user.ObjectId, true);
acl.SetWriteAccess(user.ObjectId, true);

todo.ACL = acl;
await todo.SaveAsync();
var todo = new ParseObject("Todo")
{
    { "title", "Private Task" }
};

// Restrict read/write to only a particular user
var acl = new ParseACL();
acl.SetPublicReadAccess(false);
acl.SetPublicWriteAccess(false);
acl.SetReadAccess(user.ObjectId, true);
acl.SetWriteAccess(user.ObjectId, true);

todo.ACL = acl;
await todo.SaveAsync();
﻿
Étape 4 – Écriture des Fonctions de Code Cloud
Pourquoi le Code Cloud ?
Le Code Cloud s'exécute sur le côté serveur de Back4App. C'est idéal pour les validations, les déclencheurs ou la logique supplémentaire pour votre projet asp.net core. Vous pouvez garder les processus sensibles sécurisés et hors du client.
Exemple de Fonction Cloud
JS
// main.js example
Parse.Cloud.define('calculateTextLength', async (request) => {
  const { text } = request.params;
  if (!text) {
    throw new Error('No text provided');
  }
  return { length: text.length };
});
// main.js example
Parse.Cloud.define('calculateTextLength', async (request) => {
  const { text } = request.params;
  if (!text) {
    throw new Error('No text provided');
  }
  return { length: text.length };
});
﻿
Déploiement
Déployer le code Cloud via :
Back4App CLI: b4a deploy
Tableau de bord: Collez le code dans Cloud Code > Fonctions et cliquez sur Déployer.
﻿
Appel des fonctions Cloud
En .NET :
C#
public async Task<Dictionary<string, object>> GetTextLength(string text)
{
    var parameters = new Dictionary<string, object> { { "text", text } };
    var result = await ParseCloud.CallFunctionAsync<Dictionary<string, object>>("calculateTextLength", parameters);
    return result;
}
public async Task<Dictionary<string, object>> GetTextLength(string text)
{
    var parameters = new Dictionary<string, object> { { "text", text } };
    var result = await ParseCloud.CallFunctionAsync<Dictionary<string, object>>("calculateTextLength", parameters);
    return result;
}
﻿
Ou via REST:
Bash
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
﻿
Étape 5 – Configuration de l'authentification
Activer l'authentification des utilisateurs
ASP.NET Core peut gérer sa propre identité. Mais si vous préférez, vous pouvez la déléguer à la classe User de Parse. Back4App gère le hachage des mots de passe, les sessions rest api et d'autres détails de sécurité.
C#
// Sign Up
public async Task SignUpUser(string username, string password, string email)
{
    var user = new ParseUser
    {
        Username = username,
        Password = password,
        Email = email
    };

    await user.SignUpAsync();
}

// Log In
public async Task<ParseUser> LogInUser(string username, string password)
{
    return await ParseUser.LogInAsync(username, password);
}
// Sign Up
public async Task SignUpUser(string username, string password, string email)
{
    var user = new ParseUser
    {
        Username = username,
        Password = password,
        Email = email
    };

    await user.SignUpAsync();
}

// Log In
public async Task<ParseUser> LogInUser(string username, string password)
{
    return await ParseUser.LogInAsync(username, password);
}
﻿
Connexion Sociale
Intégrer Facebook, Google, ou d'autres fournisseurs si désiré en configurant les paramètres OAuth dans le tableau de bord Back4App. Référez-vous à Documentation de Connexion Sociale.﻿
Étape 6 – Gestion du Stockage de Fichiers
Téléchargement de Fichiers
Utilisez ParseFile pour télécharger des images ou des documents :
C#
public async Task<ParseFile> UploadImage(byte[] fileBytes, string fileName)
{
    var parseFile = new ParseFile(fileName, fileBytes);
    await parseFile.SaveAsync();
    return parseFile;
}
public async Task<ParseFile> UploadImage(byte[] fileBytes, string fileName)
{
    var parseFile = new ParseFile(fileName, fileBytes);
    await parseFile.SaveAsync();
    return parseFile;
}
﻿
Sécurité des Fichiers
Configurez les téléchargements de fichiers dans Paramètres de l'Application > Sécurité & Clés, en ajustant qui peut télécharger ou accéder aux fichiers. Cela protège les données des utilisateurs dans votre application web.
Étape 7 – Vérification par Email et Réinitialisation de Mot de Passe
Pourquoi c'est Important
La vérification par email garantit que les utilisateurs possèdent l'email fourni. La réinitialisation de mot de passe est cruciale pour une expérience utilisateur sécurisée dans vos solutions asp.net core.
Activez-le sur Back4App
Allez dans Paramètres d'Email dans votre tableau de bord Back4App.
Activez Activer la vérification par email.
Ajustez le modèle de réinitialisation de mot de passe pour correspondre à votre image de marque.
Étape 8 – Planification des tâches avec Cloud Jobs
Automatiser les tâches en arrière-plan
Utilisez Cloud Jobs pour exécuter des tâches récurrentes, comme supprimer des données anciennes ou envoyer des rappels. Par exemple, cleanupOldTodos:
JS
// main.js
Parse.Cloud.job('cleanupOldTodos', async (request) => {
  const Todo = Parse.Object.extend('Todo');
  const query = new Parse.Query(Todo);

  const now = new Date();
  const THIRTY_DAYS = 30 * 24 * 60 * 60 * 1000;
  const cutoff = new Date(now - THIRTY_DAYS);

  query.lessThan('createdAt', cutoff);
  const oldTodos = await query.find({ useMasterKey: true });
  await Parse.Object.destroyAll(oldTodos, { useMasterKey: true });
  return `Deleted ${oldTodos.length} old Todos.`;
});
// main.js
Parse.Cloud.job('cleanupOldTodos', async (request) => {
  const Todo = Parse.Object.extend('Todo');
  const query = new Parse.Query(Todo);

  const now = new Date();
  const THIRTY_DAYS = 30 * 24 * 60 * 60 * 1000;
  const cutoff = new Date(now - THIRTY_DAYS);

  query.lessThan('createdAt', cutoff);
  const oldTodos = await query.find({ useMasterKey: true });
  await Parse.Object.destroyAll(oldTodos, { useMasterKey: true });
  return `Deleted ${oldTodos.length} old Todos.`;
});
﻿
Définissez le calendrier sous Paramètres du serveur > Tâches en arrière-plan dans le tableau de bord Back4App.
Étape 9 – Intégration des Webhooks
Utilisation des Webhooks
Les Webhooks permettent à votre asp.net core backend d'appeler des services externes chaque fois que les données changent. Par exemple, notifier un canal Slack lorsqu'un nouveau Todo est créé.
Accédez aux Webhooks sous Plus > WebHooks.
Ajoutez un nouvel endpoint.
Choisissez l'événement (par exemple, créer Todo).
Ajout d'un Webhook
﻿
Étape 10 – Explorer le panneau d'administration Back4App
Aperçu
L' Application d'administration Back4App aide les utilisateurs non techniques à gérer les données (CRUD) sans accéder au code. Elle est centrée sur le modèle et simple.
Activer cela sous Tableau de bord de l'application > Plus > Application Admin > Activer l'application Admin:
Activer l'application Admin
﻿
Créez un utilisateur Admin et choisissez un sous-domaine. Ensuite, connectez-vous avec vos nouvelles informations d'identification :
﻿
Avec l'application Admin, vous et votre équipe pouvez gérer rapidement des tâches de données essentielles, améliorant ainsi la collaboration et libérant du temps de développement.
Conclusion
Vous avez appris à construire un backend pour ASP.NET Core en utilisant Back4App pour rationaliser les données, la sécurité et la fonctionnalité. En combinant une plateforme open source avec vos compétences en .NET Core, vous avez maintenant :
Une structure de base de données évolutive avec des ACL et des CLP.
Des requêtes en temps réel pour des mises à jour instantanées des données.
Cloud Code pour une logique côté serveur sécurisée.
Des points de terminaison API web intégrés pour votre flux de développement web.
Des tâches Cloud automatisées et des webhooks pour étendre votre backend.
Un panneau d'administration facile à utiliser pour gérer les données.
Avec ces bases en place, vous pouvez développer des applications ASP.NET Core complètes qui offrent des expériences utilisateur de premier ordre et gèrent un trafic à grande échelle sans effort.
Prochaines étapes
Passer en production: Renforcez les règles de sécurité, optimisez les performances et tirez parti des analyses de Back4App.
Ajouter des fonctionnalités avancées: Expérimentez avec des rôles, un accès basé sur les rôles ou des API tierces (par exemple, Stripe, Slack).
Plongez plus profondément dans Cloud Code: Écrivez des déclencheurs personnalisés, intégrez-vous à des services externes ou gérez des flux de travail complexes.
Consultez la documentation officielle de Back4App: Documentation Back4App offre des conseils sur l'utilisation avancée.
Développez votre projet ASP.NET Core avec des modèles MVC plus riches, des microservices ou des flux d'authentification spécialisés.
﻿
Mis à jour 23 Jan 2025
Cette page vous a-t-elle aidée?
Comment construire un backend pour NativeScript ?
Comment construire un backend pour C# ?