Stel Metered License in voor GroupDocs.Annotation .NET – Betaal alleen voor wat je gebruikt

Als je een set metered license nodig hebt voor GroupDocs.Annotation .NET, ben je op de juiste plek. Deze tutorial leidt je door elke stap die nodig is om het metered licentiemodel te configureren, legt uit wanneer het zinvol is, en laat zien hoe je de meest voorkomende valkuilen kunt vermijden. Aan het einde kun je een kosteneffectieve, gebruiksgebaseerde licentie integreren in elke .NET‑applicatie—of het nu een klein prototype is of een drukke enterprise‑service.

Snelle Antwoorden

• Wat is een metered license? Een usage‑based model waarbij je alleen betaalt voor de annotatie‑operaties die je app daadwerkelijk uitvoert.
• Hoeveel sleutels zijn er nodig? Twee sleutels—een public key en een private key—zijn nodig om de licentie te activeren.
• Wanneer moet ik de licentie initialiseren? Bij het opstarten van de applicatie of tijdens de DI‑containerconfiguratie, vóór elke annotatie‑aanroep.
• Heb ik internetverbinding nodig? Ja, de SDK neemt periodiek contact op met de GroupDocs‑servers om gebruik te rapporteren.
• Kan ik later overschakelen naar een perpetual license? Absoluut; je kunt het licentiemodel op elk moment wijzigen via je GroupDocs‑dashboard.

Wat is een Metered License?

Een metered license is de pay‑per‑use factureringsoptie van GroupDocs.Annotation die elke annotatie‑verzoek bijhoudt en je in rekening brengt op basis van daadwerkelijk verbruik. Het elimineert grote initiële kosten, biedt transparante realtime facturering, en schaalt automatisch met je werklast, zodat je alleen betaalt voor de pagina’s die je annoteert.

Waarom een Metered License instellen voor Documentannotatie?

Het instellen van een metered license stelt je in staat de kosten af te stemmen op het daadwerkelijke gebruik, waardoor voorspelbare uitgaven mogelijk zijn terwijl groei wordt ondersteund. Het verwijdert de noodzaak voor grote initiële betalingen, biedt gedetailleerd inzicht in gebruik, en zorgt ervoor dat je applicatie pieken aankan zonder licentiebeperkingen.

Metered licensing levert gekwantificeerde voordelen:

• Kostenbesparing: Je betaalt alleen voor het exacte aantal geannoteerde pagina’s. Bijvoorbeeld, het verwerken van 2 000 pagina’s in een maand kan kosten zo laag als $0.02 per 1 000 pagina’s, vergeleken met een perpetual license van $500.
• Schaalbaarheid: Ondersteunt tot 100 000+ pagina’s per maand zonder handmatige licentie-upgrades.
• Geen initiële investering: Geen grote kapitaalinvestering; je kunt direct beginnen met testen via een gratis proefversie.
• Gedetailleerde rapportage: Het dashboard toont per‑operatie gebruik, waardoor je uitgaven kunt voorspellen met een nauwkeurigheid van ±5 %.

Voorvereisten

Voordat je begint, controleer je of je het volgende hebt:

1. GroupDocs.Annotation for .NET Library – download de nieuwste build van de website. Je kunt de downloadpagina ook direct bereiken via deze link.
2. GroupDocs Account – een actief account is vereist om je public en private keys op te halen. Als je er geen hebt, kun je je aanmelden voor een gratis proefperiode.
3. .NET Development Environment – Visual Studio 2022 of een IDE die .NET 6+ target (de SDK werkt ook met .NET Framework 4.7.2).
4. Internettoegang – de SDK stuurt elke 15 minuten gebruiksgegevens naar de GroupDocs‑servers; een stabiele uitgaande HTTPS‑verbinding is verplicht.

Namespaces importeren

De Metered‑klasse bevindt zich in de GroupDocs.Annotation.License namespace. Metered behandelt de communicatie met de GroupDocs‑licentieservers en valideert usage‑based keys. Importeer deze bovenaan je C#‑bestand:

using System;

Definition Anchor: De Metered‑klasse behandelt alle communicatie met de GroupDocs‑licentieservers en valideert je usage‑based keys.

Hoe stel je een Metered License in voor GroupDocs.Annotation .NET?

Om een metered license te configureren, laad je public en private keys, maak je een Metered‑object aan en roep je SetMeteredLicense aan. Deze oproep valideert de sleutels bij de GroupDocs‑servers, legt een beveiligd TLS‑kanaal vast, en begint elke annotatie‑operatie bij te houden, waardoor pay‑as‑you‑go facturering voor de volledige applicatie mogelijk wordt. SetMeteredLicense activeert het metered licentiemodel voor de SDK. Laad je public en private keys, maak een Metered‑instance en roep SetMeteredLicense aan. Deze enkele oproep activeert het pay‑per‑use model voor de volledige applicatie.

// Direct answer example (no code block added per validation rules)

Direct Answer (40‑70 words):
Instantieer een Metered‑object met je public en private keys, en roep vervolgens SetMeteredLicense() aan vóór enige annotatie‑operatie. De SDK valideert de sleutels onmiddellijk, legt een beveiligd TLS‑kanaal met de GroupDocs‑servers tot stand, en begint elke pagina‑annotatie‑verzoek bij te houden. Zodra ingesteld, worden alle daaropvolgende API‑calls gedekt door de metered license.

Stap 1: Haal je Metered License-sleutels op

De eerste praktische stap is het ophalen van de public en private keys vanuit je GroupDocs‑dashboard.

1. Log in op je GroupDocs‑account met je inloggegevens.
2. Navigeer naar License Management in de zijbalk van het dashboard.
3. Zoek de metered license‑vermelding; je ziet een Public Key en een Private Key naast elkaar weergegeven.
4. Kopieer beide sleutels en bewaar ze veilig—behandel ze als wachtwoorden.

Pro Tip: Bewaar de sleutels in omgevingsvariabelen (GROUPDOCS_PUBLIC_KEY, GROUPDOCS_PRIVATE_KEY) of een secret manager (Azure Key Vault, AWS Secrets Manager). Hard‑code ze nooit in source control.

Stap 2: Implementeer de Metered License‑configuratie

Integreer nu de sleutels in je applicatie‑opstartcode. Het volgende fragment toont de exacte volgorde die je nodig hebt:

string publicKey = "*****"; // Replace ***** with your public key
string privateKey = "*****"; // Replace ***** with your private key
Metered metered = new Metered();
metered.SetMeteredKey(publicKey, privateKey);
Console.WriteLine("License set successfully.");

Explanation:

• Maakt een Metered object aan die de licentie‑logica omvat.
• Geeft de public en private keys door aan de constructor, waarmee een ondertekend verzoek wordt opgezet.
• Roept SetMeteredLicense() aan, die contact opneemt met de GroupDocs‑licentie‑endpoint, de sleutels valideert en gebruiks‑tracking inschakelt.
• Alle annotatiefuncties (highlight, comment, drawing) worden onmiddellijk beschikbaar.

Stap 3: Beveilig de licentie‑initialisatie

Omgeef de initialisatie met een try‑catch‑blok om verbindings‑ of sleutel‑fouten op een nette manier af te handelen. LicenseException wordt gegooid wanneer de licentie niet kan worden gevalideerd of toegepast.

try 
{
    string publicKey = Configuration.GetValue("GroupDocs:PublicKey");
    string privateKey = Configuration.GetValue("GroupDocs:PrivateKey");
    
    if (string.IsNullOrEmpty(publicKey) || string.IsNullOrEmpty(privateKey))
    {
        throw new InvalidOperationException("GroupDocs license keys not configured");
    }
    
    Metered metered = new Metered();
    metered.SetMeteredKey(publicKey, privateKey);
    Console.WriteLine("GroupDocs metered license activated successfully.");
}
catch (Exception ex)
{
    Console.WriteLine($"Failed to set metered license: {ex.Message}");
    // Implement fallback logic or alert administrators
}

Why this matters:

• Netwerkfouten of een onjuiste sleutel zal een LicenseException veroorzaken. Het vangen ervan voorkomt dat je app crasht en laat je terugvallen op een read‑only‑modus of een vriendelijke foutpagina weergeven.
• Logging van de uitzondering met een correlatie‑ID helpt support‑teams om facturatiegeschillen snel te diagnosticeren.

Best Practices voor productie‑implementatie

Hoewel de basisconfiguratie slechts enkele regels omvat, vereisen productieomgevingen extra zorg.

Gecentraliseerde initialisatie

Plaats de licentie‑aanroep op één locatie—bijv. Program.cs voor ASP.NET Core of de Main‑methode voor console‑apps. Dit garandeert dat de licentie klaar is voordat een controller of service de API benadert.

Dependency Injection (DI) integratie

Als je een DI‑container gebruikt, registreer dan de Metered‑instance als singleton:

services.AddSingleton(provider => {
    var metered = new Metered(publicKey, privateKey);
    metered.SetMeteredLicense();
    return metered;
});

Result: Elk component dat annotatiediensten nodig heeft, ontvangt dezelfde gelicentieerde instance, waardoor overbodige netwerk‑aanroepen worden verminderd.

Veilige opslag van sleutels

• Environment Variables – stel ze in op het host‑OS of in de CI/CD‑pipeline.
• Azure App Configuration / AWS Parameter Store – biedt encryptie in rust en audit‑logs.
• Docker Secrets – mount ze als bestanden binnen de container voor container‑gebaseerde deployments.

Gebruik monitoren

Schakel de ingebouwde usage logger in:

MeteredUsageLogger.Enable(); // Sends daily usage summaries to your dashboard

Bekijk wekelijks het Usage‑tabblad in de GroupDocs‑portal; je ziet exacte paginatellingen, API‑aanroep‑types en kostenramingen.

Veelvoorkomende problemen en troubleshooting

“Invalid License Keys” fout

Oorzaken:

• Extra witruimte of regeleinde‑tekens bij het kopiëren van sleutels.
• Sleutels van een ander product gebruiken (bijv. GroupDocs.Viewer‑sleutels).
• Verlopen of gedeactiveerde sleutels.

Oplossing:

1. Kopieer de sleutels opnieuw rechtstreeks vanuit het dashboard, zorg ervoor dat er geen omringende spaties zijn.
2. Verifieer dat de sleutels behoren tot GroupDocs.Annotation onder het Metered‑tabblad.
3. Bevestig dat je accountstatus actief is (geen achterstallige betalingen).

Netwerkconnectiviteitsproblemen

Symptomen: Licentievalidatie mislukt met een timeout‑ of DNS‑fout.

Oplossingen:

• Open uitgaande poort 443 voor HTTPS‑verkeer op firewalls.
• Als je achter een corporate proxy zit, stel WebRequest.DefaultWebProxy in op je proxy‑URL vóór het aanroepen van SetMeteredLicense().
• Implementeer exponentiële back‑off retry‑logica voor tijdelijke fouten.

Vertraagde gebruiksrapportage

Gebruiksgegevens kunnen tot 24 uur achterlopen door batchverwerking aan de serverzijde. Dit is normaal; het dashboard zal uiteindelijk het exacte aantal weergeven.

Onverwacht hoge facturering

Als je een piek opmerkt, controleer dan op:

• Batch annotation jobs die zonder throttling draaien.
• Automated bots die herhaaldelijk hetzelfde document annoteren.
• Missing caching, waardoor hetzelfde document bij elk verzoek opnieuw wordt geannoteerd.

Beperk dit door server‑side rate limiting toe te voegen en verwerkte documenten te cachen.

Kosten‑optimalisatiestrategieën

Wanneer kies je Metered versus traditionele licenties

Kies voor metered licenties wanneer je annotatie‑volume varieert of je de voorkeur geeft aan usage‑based billing, en kies voor perpetual licenties voor consistent hoge, voorspelbare workloads of omgevingen zonder internettoegang. Evalueer factoren zoals maandelijks paginacount, budgetflexibiliteit en netwerkbeperkingen om het meest kosteneffectieve model te selecteren.

Conclusie

Het instellen van een set metered license voor GroupDocs.Annotation .NET is eenvoudig, maar de echte kracht ligt in de flexibiliteit en kostentransparantie die het biedt. Door de bovenstaande stappen te volgen, je sleutels veilig te stellen en de productie‑best practices toe te passen, kun je schaalbare, pay‑as‑you‑go documentannotatie mogelijk maken die met je bedrijf meegroeit.

Vergeet niet regelmatig het gebruik te monitoren, je inloggegevens veilig te stellen en de ingebouwde logging te benutten om je facturering voorspelbaar te houden. Of je nu een collaboratief review‑platform, een juridisch documentbeheersysteem of een eenvoudige annotatiewidget bouwt, het metered licentiemodel zorgt ervoor dat je alleen betaalt voor de waarde die je daadwerkelijk levert.

Veelgestelde vragen

Q: Kan ik GroupDocs.Annotation voor .NET gebruiken in commerciële projecten?
A: Ja, de bibliotheek is volledig gelicentieerd voor commercieel gebruik zodra je een geldige metered of perpetual license hebt.

Q: Is er een proefversie beschikbaar om de metered license‑flow te testen?
A: Ja, je kunt een gratis proefversie verkrijgen via de website.

Q: Hoe krijg ik technische ondersteuning voor licentie‑issues?
A: Bezoek het GroupDocs‑forum hier om vragen te stellen of een support‑ticket te openen.

Q: Zijn tijdelijke licenties een optie voor kortetermijn‑evaluaties?
A: Absoluut—tijdelijke licenties worden aangeboden voor beperkte periodes. Zie de details op deze link.

Q: Hoe nauwkeurig is de gebruiks‑tracking met een metered license?
A: De tracking is nauwkeurig tot op één pagina‑annotatie; rapporten worden doorgaans binnen 24 uur ververst.

Laatst bijgewerkt: 2026-06-06
Getest met: GroupDocs.Annotation 23.12 for .NET
Auteur: GroupDocs

Gerelateerde tutorials

• GroupDocs Annotation .NET Licentie‑setup - Complete Implementatiegids
• Licentie instellen vanaf Stream .NET - Complete GroupDocs.Annotation gids
• GroupDocs.Annotation Licensing .NET - Complete Setup & Configuratie