Actualmente tenemos una variedad de alternativas para guardar documentos o imagenes, sobre todo de opciones en la nube. Una de las alternativas puede ser firebase storage que nos permite conectarnos desde cualquier app indpeendiente el lenguaje. En esta ocasión integraremos una Api en .Net 5 con firebase storage.
Este post esta divididos en tres partes:
- Creación de proyecto en firebase
- Crear un usuario en firebase
- Integración de Api en .Net 5
Creación de proyecto en firebase
Primero debemos contar con una cuenta de google.
Luego debemos ingresar a la consola de firebase
Creamos un nuevo poyecto
Paso 1: Nombre del proyecto
Paso 2: desactivamos google analitycs para el proyecto
Una vez creado el proyecto seleccionamos storage del menu
Iniciamos en modo producción y seleccionamos ubicación
En la sección reglas (rules) copiamos y pegamos el siguiente código
rules_version = '2';
service firebase.storage {
match /b/{bucket}/o {
match /{allPaths=**} {
allow read, write: if request.auth != null;
}
}
}
Crear un usuario en firebase
Para poder acceder a firebase storage debemos crear un usuario en la sección Authentication y le damos a comenzar
Seleccionamos el metodo de autenticación por correo electrónico
En la pestaña users agregamos un nuevo usuario
Integración de Api en .Net 5
Ya realizados los pasos anteriores, estamos listos para conectar nuestra api .Net 5 a firebase. Para ello utilizaremos el código del siguiente repositorio:
Net Core Firebase Storage
El proyecto se divide en tres capas
- FirebaseStorageApp
- FirebaseStorageApp.Model
- FirebaseStorageApp.Services
FirebaseStorageApp
Es nuestra api donde exponemos el endpoint para cargar documentos:
[HttpPost]
public async Task<IActionResult> Post([FromBody] FileModel file)
{
string fileUrlFirebase = await Upload(file);
return Ok(new { fileUrlFirebase });
}
private static async Task<string> Upload(FileModel file)
{
var fileFromBase64ToStream = FirebaseStorageService.ConvertBase64ToStream(file.FileBase64);
var fileStream = fileFromBase64ToStream.ReadAsStream();
string fileUrlFirebase = await FirebaseStorageService.UploadFile(fileStream, file);
return fileUrlFirebase;
}
Para este ejemplo utilizaremos variables de entorno con las keys necesarias para conectarse a firebase. Estas variables debemos reemplazarlas en el archivo Properties/launchSettings.json:
"IIS Express": {
"commandName": "IISExpress",
"launchBrowser": true,
"launchUrl": "swagger",
"environmentVariables": {
"ASPNETCORE_ENVIRONMENT": "Development",
"API_KEY_STORAGE": "Your api key storage",
"AUTH_EMAIL": "your email authentication ",
"AUTH_PASWORD": "your password autenticaction",
"BUCKET_STORAGE": "your bucket name"
}
}
AUTH_EMAIL y AUTH_PASWORD: debemos ingresar las configuradas en el paso 2 de este post.
API_KEY_STORAGE: en firebase la obtenemos en Configuración del proyecto < General:
BUCKET_STORAGE: en firebase la obtenemos en storage omitiendo gs://:
FirebaseStorageApp.Model
En esta capa tenemos la clase con los datos que solicitaremos para guardar documentos. Esta sera utilizada en el controlador y la capa de servicio.
public class FileModel
{
[Required(ErrorMessage = "This field is required")]
[MinLength(5, ErrorMessage = "5 characters is required")]
public string FileBase64 { get; set; }
[Required(ErrorMessage = "This field is required")]
[MinLength(5, ErrorMessage = "5 characters is required")]
public string FileName { get; set; }
[Required(ErrorMessage = "This field is required")]
[MinLength(5, ErrorMessage = "5 characters is required")]
public string FolderName { get; set; }
}
FirebaseStorageApp.Services
Esta es nuestra capa de servicio en donde conectaremos con firebase.
Para ello debemos instalar dos nugget package, FirebaseAuthentication.net y FirebaseStorage.net:
Una vez descargados ya podemos concectarnos con la siguiente clase:
public static class FirebaseStorageService
{
private static readonly string _apiKey = Environment.GetEnvironmentVariable("API_KEY_STORAGE");
private static readonly string _bucket = Environment.GetEnvironmentVariable("BUCKET_STORAGE");
private static readonly string _email = Environment.GetEnvironmentVariable("AUTH_EMAIL");
private static readonly string _Password = Environment.GetEnvironmentVariable("AUTH_PASWORD");
public static StreamContent ConvertBase64ToStream(string fileBase64)
{
byte[] stringToBase64 = Convert.FromBase64String(fileBase64);
StreamContent streamContent = new(new MemoryStream(stringToBase64));
return streamContent;
}
public static async Task<string> UploadFile(Stream stream, FileModel file)
{
string fileFromFirebaseStorage = string.Empty;
FirebaseAuthProvider firebaseConfiguration = new(new FirebaseConfig(_apiKey));
FirebaseAuthLink authConfiguration = await firebaseConfiguration
.SignInWithEmailAndPasswordAsync(_email, _Password);
CancellationTokenSource cancellationToken = new();
FirebaseStorageTask storageManager = new FirebaseStorage(_bucket,
new FirebaseStorageOptions
{
AuthTokenAsyncFactory = () => Task.FromResult(authConfiguration.FirebaseToken),
ThrowOnCancel = true
})
.Child(file.FolderName)
.Child(file.FileName)
.PutAsync(stream, cancellationToken.Token);
try
{
fileFromFirebaseStorage = await storageManager;
}
catch (Exception e)
{
}
return fileFromFirebaseStorage;
}
}
Explicado el codigo de forma general ya estamos en condiciones de cargar nuestros archivo. En el siguiente link puedes obtener el json dejemplo para probar la api: Example Body
Al ejecutar el post el endpoint nos devolvera la url para visualizar el documento cargado:
{
"fileUrlFirebase": "https://firebasestorage.googleapis.com/v0/b/pruebas-fc979.appspot.com/o/documents%2Fpdf_prueba?alt=media&token=6a52c316-661a-48b6-8505-206f3a4b202a"
}
Si revisamos en la consola veremos el nuevo archivo cargado
Latest comments (0)