Kryptera, dekryptera, digitalt signera och säkerställ Excel-filer med Aspose.Cells Cloud API
Säkerställa och av säkerställa Excel-filer
Vad innebär “säkerställa” i Aspose.Cells Cloud?
Säkerställnings-åtgärden skyddar en Excel-arbetsbok genom att tillämpa ett lösenord som begränsar möjligheten att öppna, redigera eller ändra filens struktur. API:et stöder även kryptering av arbetsboken, dekryptering samt tillägg av en digital signatur för ändringsbevis.
API-referens
| HTTP-metod | Endpoint | Nödvändiga fråge- eller brödparametrar | Exempel på brödtext | Typiska svar |
|---|---|---|---|---|
| POST | https://api.aspose.cloud/v3.0/cells/{fileName}/protect |
fileName (sökväg), password (fråga) |
{ "password": "MySecret123" } |
200 OK – skydd tillämpat, 400 Bad Request, 401 Unauthorized, 500 Internal Server Error |
| POST | https://api.aspose.cloud/v3.0/cells/{fileName}/unprotect |
fileName (sökväg), password (fråga) |
Ingen | 200 OK – skydd borttaget, felkoder enligt ovan |
| POST | https://api.aspose.cloud/v3.0/cells/{fileName}/encrypt |
fileName (sökväg), password (fråga) |
Ingen | 200 OK – filen krypterad |
| POST | https://api.aspose.cloud/v3.0/cells/{fileName}/decrypt |
fileName (sökväg), password (fråga) |
Ingen | 200 OK – filen dekrypterad |
| POST | https://api.aspose.cloud/v3.0/cells/{fileName}/sign |
fileName (sökväg) |
{ "certificatePath": "/certs/mycert.pfx", "certificatePassword": "certPass" } |
200 OK – digital signatur tillagd |
Kodexempel (C#)
using Aspose.Cells.Cloud.SDK.Api;
using Aspose.Cells.Cloud.SDK.Model.Requests;
// Initiera API-klienten
var config = new Configuration
{
AppSid = "DIN_APP_SID",
AppKey = "DIN_APP_KEY",
BaseUrl = "https://api.aspose.cloud"
};
var api = new CellsApi(config);
// Säkerställ arbetsboken
var protectRequest = new PostProtectWorkbookRequest(
name: "Sample.xlsx",
password: "MySecret123"
);
api.PostProtectWorkbook(protectRequest);
Förutsättningar
- En aktiv Aspose.Cells Cloud-prenumeration.
AppSidochAppKeyför autentisering.
Autentisering
Alla förfrågningar måste inkludera Authorization-huvudet med ett giltigt JWT-token hämtat från autentiseringsendpointen hos Aspose Cloud.
Felhantering
Kontrollera HTTP-statuskoden och Error-objektet som returneras i svarets brödtext. Vanliga fel inkluderar ogiltigt lösenord (400), saknad fil (404) samt autentiseringsfel (401).
Anteckningar
-
Samma endpoint kan användas för att kryptera eller dekryptera genom att ändra åtgärdssegmentet (
/encrypt,/decrypt). -
Digitala signaturer kräver en giltig certifikatfil som är tillgänglig för API:et.