Quickstarters
Cara Membangun Backend untuk ASP.NET Core?

33min
Pendahuluan
Dalam tutorial ini, Anda akan belajar bagaimana membangun backend untuk ASP.NET Core menggunakan Back4App. 
Dengan mengintegrasikan fitur-fitur penting Back4App—seperti manajemen database, Cloud Code, REST dan GraphQL API, otentikasi pengguna, dan kueri waktu nyata—Anda akan mendapatkan solusi backend lengkap untuk aplikasi ASP.NET Core Anda. 
Pendekatan ini mendukung pembangunan aplikasi web yang dapat diskalakan, menangani logika sisi server dengan pengaturan minimal.
Dengan Back4App, Anda dapat mempercepat pengembangan backend untuk proyek ASP.NET Core Anda. Anda akan memanfaatkan platform sumber terbuka yang mendukung infrastruktur web api yang andal, konektivitas database, dan fungsi cloud yang kuat. 
Pada akhir tutorial ini, Anda akan memiliki fondasi yang berfungsi untuk backend yang aman dan dapat diperluas yang menawarkan pengalaman pengguna yang lebih baik dan menangani data waktu nyata. Anda kemudian dapat memperluas solusi net core Anda atau mengintegrasikannya dengan layanan lain sesuai kebutuhan.
Prasyarat
Akun Back4App dan proyek Back4App baru
Memulai dengan Back4app.
Jika Anda tidak memiliki akun, Anda dapat membuat satu secara gratis.
Lingkungan Pengembangan ASP.NET Core
Pastikan Anda telah menginstal .NET SDK (versi 6.0 atau lebih tinggi). Unduh .NET﻿
Keterampilan dalam C# dan ASP.NET Core
Dokumentasi Resmi ASP.NET Core.﻿
Opsional: Jika Anda berencana untuk menggunakan Parse .NET SDK, Anda perlu Parse-SDK-dotNET atau referensi dalam file .csproj Anda.
Pastikan Anda memiliki semua prasyarat ini sebelum Anda mulai. Memiliki proyek Back4App dan ASP.NET Core lingkungan siap akan membuat langkah-langkahnya jauh lebih mudah diikuti.
Langkah 1 – Membuat Proyek Baru di Back4App dan Menghubungkan
Mengapa Langkah Ini?
Backend ASP.NET Core Anda dimulai dengan proyek Back4App. Proyek ini adalah fondasi sisi server Anda, mengelola database, aturan keamanan, dan pengaturan aplikasi.
Membuat Proyek
Masuk ke akun Back4App Anda.
Klik “Aplikasi Baru” dari dasbor Anda.
Beri nama aplikasi Anda (misalnya, “AspNetCore-Backend-Tutorial”).
﻿
Setelah pembuatan, Anda akan melihatnya terdaftar di dasbor Anda. Aplikasi baru ini adalah pusat utama Anda untuk pengembangan backend tugas.
Menginstal Parse .NET SDK (Opsional)
Meskipun Anda dapat menggunakan REST API atau GraphQL secara langsung, Parse .NET SDK dapat menyederhanakan operasi data dalam solusi ASP.NET Core Anda. Jika Anda ingin mengintegrasikannya:
Tambahkan Parse SDK ke .csproj Anda atau melalui NuGet Package Manager:
Inisialisasi SDK dalam aplikasi ASP.NET Core Anda (misalnya, Program.cs atau Startup.cs):
Ganti placeholder dengan kredensial dari “Pengaturan Aplikasi” > “Keamanan & Kunci” aplikasi Back4App Anda. Ini menghubungkan proyek asp.net core Anda ke lingkungan sisi server Back4App.
Langkah 2 – Menyiapkan Database
1. Membuat Model Data
Gunakan dasbor Back4App untuk mendefinisikan skema kelas Anda. Misalnya, kelas Todo dengan kolom seperti title (String) dan isCompleted (Boolean):
Buat Kelas Baru
﻿
2. Membuat Model Data Menggunakan AI Agent
Buka AI Agent di dasbor Back4App Anda dan deskripsikan model data Anda. Misalnya, “Buat kelas ToDo baru untuk aplikasi asp.net core saya.” AI Agent kemudian mengatur skema untuk Anda.
﻿
3. Membaca dan Menulis Data Menggunakan Parse .NET SDK
Berikut adalah cara Anda dapat membuat dan mengambil Todo item di 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. Membaca dan Menulis Data Menggunakan REST API
Sebagai alternatif, Anda dapat menggunakan pendekatan REST API :
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. Membaca dan Menulis Data Menggunakan GraphQL API
Untuk menggunakan GraphQL, kirimkan kueri atau mutasi ke endpoint GraphQL 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. Bekerja dengan Live Queries
Aktifkan pembaruan waktu nyata dengan menghidupkan Live Queries di dasbor Anda (di bawah Pengaturan Server). Kemudian gunakan pendekatan .NET atau WebSocket untuk berlangganan. Ini menjaga data tetap segar di aplikasi web Anda tanpa panggilan tambahan.
Langkah 3 – Menerapkan Keamanan dengan ACL dan CLP
Gambaran Umum ACL dan CLP
ACL (Daftar Kontrol Akses) mengamankan objek individu. CLP (Izin Tingkat Kelas) mengamankan seluruh kelas. Pendekatan berlapis ini menjaga data tetap aman di asp.net core lingkungan Anda.
﻿
Mengatur Izin Tingkat Kelas
Buka Database tab di dasbor Back4App Anda.
Pilih kelas Todo.
Klik Izin Tingkat Kelas.
Sesuaikan baca/tulis untuk peran publik atau terautentikasi.
Mengonfigurasi ACL dalam Kode
Dengan Parse .NET SDK, Anda dapat mengatur ACL di tingkat objek:
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();
﻿
Langkah 4 – Menulis Fungsi Kode Cloud
Mengapa Kode Cloud?
Kode Cloud berjalan di sisi server, Back4App. Ini ideal untuk validasi, pemicu, atau logika tambahan untuk proyek asp.net core. Anda dapat menjaga proses sensitif tetap aman dan tidak di sisi klien.
Contoh Fungsi 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 };
});
﻿
Penerapan
Terapkan Cloud Code melalui:
Back4App CLI: b4a deploy
Dasbor: Tempelkan kode ke Cloud Code > Fungsi dan klik Terapkan.
﻿
Memanggil Cloud Functions
Dalam .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;
}
﻿
Atau melalui 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
﻿
Langkah 5 – Mengonfigurasi Autentikasi
Aktifkan Autentikasi Pengguna
ASP.NET Core dapat mengelola identitasnya sendiri. Tetapi jika Anda lebih suka, Anda dapat menyerahkannya kepada User kelas Parse. Back4App menangani hashing kata sandi, rest api sesi, dan detail keamanan lainnya.
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);
}
﻿
Login Sosial
Integrasikan Facebook, Google, atau penyedia lain jika diinginkan dengan mengonfigurasi pengaturan OAuth di dasbor Back4App. Lihat Dokumentasi Login Sosial.﻿
Langkah 6 – Menangani Penyimpanan File
Mengunggah File
Gunakan ParseFile untuk mengunggah gambar atau dokumen:
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;
}
﻿
Keamanan File
Konfigurasikan unggahan file di Pengaturan Aplikasi > Keamanan & Kunci, menyesuaikan siapa yang dapat mengunggah atau mengakses file. Ini melindungi data pengguna di aplikasi web Anda.
Langkah 7 – Verifikasi Email dan Reset Kata Sandi
Mengapa Ini Penting
Verifikasi email memastikan pengguna memiliki email yang diberikan. Reset kata sandi sangat penting untuk pengalaman pengguna yang aman di solusi asp.net core Anda.
Aktifkan di Back4App
Pergi ke Pengaturan Email di dasbor Back4App Anda.
Aktifkan Aktifkan verifikasi email.
Sesuaikan template reset kata sandi untuk mencocokkan merek Anda.
Langkah 8 – Menjadwalkan Tugas dengan Cloud Jobs
Automatisasi Tugas Latar Belakang
Gunakan Cloud Jobs untuk menjalankan tugas berulang, seperti menghapus data lama atau mengirim pengingat. Misalnya, 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.`;
});
﻿
Atur jadwal di bawah Pengaturan Server > Tugas Latar Belakang di dasbor Back4App.
Langkah 9 – Mengintegrasikan Webhooks
Menggunakan Webhooks
Webhooks memungkinkan asp.net core backend Anda memanggil layanan eksternal setiap kali data berubah. Misalnya, beri tahu saluran Slack ketika Todo baru dibuat.
Navigasi ke Webhooks di bawah Lainnya > WebHooks.
Tambahkan endpoint baru.
Pilih acara (misalnya, buat Todo).
Menambahkan Webhook
﻿
Langkah 10 – Menjelajahi Panel Admin Back4App
Ikhtisar
Aplikasi Admin Back4App membantu pengguna non-teknis mengelola data (CRUD) tanpa mengakses kode. Ini berfokus pada model dan sederhana.
Aktifkan itu di bawah Dasbor Aplikasi > Lainnya > Aplikasi Admin > Aktifkan Aplikasi Admin:
Aktifkan Aplikasi Admin
﻿
Buat pengguna Admin dan pilih subdomain. Kemudian masuk dengan kredensial baru Anda:
﻿
Dengan Aplikasi Admin, Anda dan tim Anda dapat menangani tugas data penting dengan cepat, meningkatkan kolaborasi dan membebaskan waktu pengembangan.
Kesimpulan
Anda telah belajar bagaimana membangun backend untuk ASP.NET Core menggunakan Back4App untuk menyederhanakan data, keamanan, dan fungsionalitas. Dengan menggabungkan platform sumber terbuka dengan keterampilan net core Anda, sekarang Anda memiliki:
Struktur database yang dapat diskalakan dengan ACL dan CLP.
Kueri Langsung waktu nyata untuk pembaruan data instan.
Cloud Code untuk logika sisi server yang aman.
Endpoint API web terintegrasi untuk alur pengembangan web Anda.
Pekerjaan Cloud otomatis dan webhook untuk memperluas backend Anda.
Panel Admin yang mudah digunakan untuk mengelola data.
Dengan fondasi ini, Anda dapat mengembangkan aplikasi asp.net core yang sepenuhnya berfungsi yang memberikan pengalaman pengguna yang sangat baik dan menangani lalu lintas berskala besar dengan mudah.
Langkah Selanjutnya
Masuk ke produksi: Perkuat aturan keamanan, optimalkan kinerja, dan manfaatkan analitik Back4App.
Tambahkan fitur lanjutan: Bereksperimen dengan peran, akses berbasis peran, atau API pihak ketiga (misalnya, Stripe, Slack).
Selami lebih dalam ke Cloud Code: Tulis pemicu kustom, integrasikan dengan layanan eksternal, atau tangani alur kerja yang kompleks.
Tinjau dokumen resmi Back4App: Dokumentasi Back4App menawarkan panduan tentang penggunaan lanjutan.
Perluas proyek ASP.NET Core Anda dengan pola MVC yang lebih kaya, mikroservis, atau alur autentikasi khusus.
﻿
Diperbarui 24 Jan 2025
Apakah halaman ini membantu Anda?
SEBELUMNYA
Cara Membangun Backend untuk NativeScript?
BERIKUTNYA
Bagaimana Membangun Backend untuk C#?