Isom.Security.SecurityProvider

 ISOM/L-Bibliothek für Serviceautoren: <br />Isom.Security.SecurityProvider

ISOM/L-Bibliothek
für Serviceautoren

Version 9.10.1.0 vom 25 November 2013

Namensraum Isom.Security.SecurityProvider

Beschreibung

Sperrung von Sonderfunktionen

Dieses Fachobjekt bietet Zugang zu kryptographischen Funktionen. Damit unterstützt es die Erfüllung von Sicherheitsaufgaben.

Hinweis: Dieses Fachobjekt funktioniert nicht mit ISOM Didact. Die meisten Funktionsaufrufe kehren mit dem Ergebnis 'Void' zurück.



Funktionen

Isom.Security.SecurityProvider.Authenticate

Führt eine Authentifizierung durch.

objectbound Isom.Base.Boolean Isom.Security.SecurityProvider.Authenticate  (  ) 

Führt eine Authentifizierung durch.

   using Isom.Base.* 
   ... 
      SecurityProvider provider = ...; 
      Boolean succ = provider.Authenticate(); 
Rückgabe:
'true' wenn die Authentifizierung erfolgreich war, 'false' sonst.
Isom.Security.SecurityProvider.CheckKeyStore

Prüft, ob ein vorher angeforderter Schlüssel erhalten wurde.

objectbound Isom.Base.Boolean Isom.Security.SecurityProvider.CheckKeyStore  (  ) 

Prüft, ob ein vorher angeforderter Schlüssel erhalten wurde.

   using Isom.Base.* 
   ... 
      SecurityProvider provider = ...; 
      StringDictionary results = provider.CheckKeyStore(); 
Rückgabe:
Ergebnis der Anforderung
Isom.Security.SecurityProvider.Clone

Erzeugt eine identische Kopie des Objekts.

objectbound Isom.Security.SecurityProvider Isom.Security.SecurityProvider.Clone  (  ) 

Erzeugt eine identische Kopie des Objekts.

Rückgabe:
Das geklonte Objekt.
Isom.Security.SecurityProvider.Create

Erzeugt ein neues Security-Provider-Objekt anhand des vorgegebenen Namens.

Isom.Security.SecurityProvider Isom.Security.SecurityProvider.Create  ( Isom.Base.String  name  ) 

Erzeugt ein neues Security-Provider-Objekt anhand des vorgegebenen Namens.

   using Isom.Base.* 
   ... 
      SecurityProvider provider = SecurityProvider.Create( "Name" ); 
   ... 

Rückgabe:
Das neu erzeugte Security-Provider-Objekt.
Isom.Security.SecurityProvider.GenerateKey

Generiert einen Schlüssel.

objectbound Isom.Base.Boolean Isom.Security.SecurityProvider.GenerateKey  (  ) 

Generiert einen Schlüssel.

   using Isom.Base.* 
   ... 
      SecurityProvider provider = ...; 
      String key = provider.GenerateKey(); 
Rückgabe:
Der erzeugte Schlüssel.
Isom.Security.SecurityProvider.GetId

Ruft die ID dieser Objekt-Instanz ab.

objectbound Isom.Base.Number Isom.Security.SecurityProvider.GetId  (  ) 

Ruft die ID dieser Objekt-Instanz ab.

   using Isom.Base.* 
   ... 
      Number id = SecurityProvider.GetId(); 
   ... 

Rückgabe:
Security-Provider-Objekt.
Isom.Security.SecurityProvider.GetProp

Ermittelt den Wert der vorgegebenen Eigenschaft (property) für den Security-Provider.

objectbound Isom.Base.String Isom.Security.SecurityProvider.GetProp  ( Isom.Base.String  propName  ) 

Ermittelt den Wert der vorgegebenen Eigenschaft (property) für den Security-Provider.

Die systemseitig ermittelten Eigenschaftsnamen sind in den herstellerspezifischen Begleitdokumenten zu finden.

   using Isom.Base.* 
   ... 
      SecurityProvider provider = ...; 
      String val = provider.GetProp( "PropertyName" ); 
Rückgabe:
Wert der Eigenschaft.
Ausnahmebehandlung:
Es wird Void zurückgegeben, wenn die Eigenschaft nicht gesetzt oder auf den Leerstring gesetzt ist.
Isom.Security.SecurityProvider.GetPropNames

Liefert die Namen aller technischen Eigenschaften für den Security-Provider.

objectbound Isom.Base.StringList Isom.Security.SecurityProvider.GetPropNames  (  ) 

Liefert die Namen aller technischen Eigenschaften für den Security-Provider.

Es werden die Eigenschaftsnamen für die technischen Eigenschaften (siehe Isom.Security.SecurityProvider.GetProp()) zurückgeliefert. Die systemseitig ermittelten Eigenschaftsnamen sind in den herstellerspezifischen Begleitdokumenten zu finden.

   Isom.Security.SecurityProvider secProvider = Isom.Security.SecurityProvider.GetInstance("Security42"); 
   Isom.Base.StringList propertyNames = secProvider.GetPropNames(); 
   propertyNames.Reset(); 
   while(propertyNames.HasNext()) 
   { 
     //Abfrage des Werts für den gelieferten Eigenschaftsnamen und z. B. Aufzeichnung ins Protokoll 
   } 
Rückgabe:
Isom.Base.StringList
Liste der Namen aller technischen Eigenschaften für den Security-Provider.
Siehe auch:
Isom.Security.SecurityProvider.GetProp()
Datum:
letzte Änderung am 09.09.2010
Isom.Security.SecurityProvider.GetProvider

Ruft das Security-Provider-Objekt mit der übergebenen ID ab.

Isom.Security.SecurityProvider Isom.Security.SecurityProvider.GetProvider  ( Isom.Base.Number  id  ) 

Ruft das Security-Provider-Objekt mit der übergebenen ID ab.

   using Isom.Base.* 
   ... 
      SecurityProvider provider = SecurityProvider.GetProvider(1); 
   ... 

Rückgabe:
Security-Provider-Objekt.
Isom.Security.SecurityProvider.IsVoid

Bestimmt, ob es sich um das Void-Objekt handelt.

objectbound Isom.Base.Boolean Isom.Security.SecurityProvider.IsVoid  (  ) 

Bestimmt, ob es sich um das Void-Objekt handelt.

Rückgabe:
'true', falls dies das Void-Objekt ist, 'false' sonst.
Isom.Security.SecurityProvider.ProvideKeyStoreData

Bringt einen mit 'RequestKeyStore' angeforderdeten und erhaltenen Schlüssel ein.

objectbound Isom.Base.Boolean Isom.Security.SecurityProvider.ProvideKeyStoreData  (  ) 

Bringt einen mit 'RequestKeyStore' angeforderdeten und erhaltenen Schlüssel ein.

   using Isom.Base.* 
   ... 
      SecurityProvider provider = ...; 
      StringDictionary results = provider.ProvideKeyStoreData(); 
Rückgabe:
Ergebnis der Anforderung
Isom.Security.SecurityProvider.ReleaseKeyStore

Gibt reservierte Ressourcen wieder frei.

objectbound Isom.Base.Boolean Isom.Security.SecurityProvider.ReleaseKeyStore  (  ) 

Gibt reservierte Ressourcen wieder frei.

   using Isom.Base.* 
   ... 
      SecurityProvider provider = ...; 
      StringDictionary results = provider.ReleaseKeyStore(); 
Rückgabe:
Ergebnis der Anforderung
Isom.Security.SecurityProvider.RequestKeyStore

Löst eine Anforderung nach einem Schlüssel aus.

objectbound Isom.Base.Boolean Isom.Security.SecurityProvider.RequestKeyStore  (  ) 

Löst eine Anforderung nach einem Schlüssel aus.

   using Isom.Base.* 
   ... 
      SecurityProvider provider = ...; 
      StringDictionary results = provider.RequestKeyStore(); 
Rückgabe:
Ergebnis der Anforderung
Isom.Security.SecurityProvider.SetProp

Setzt den Wert der vorgegebenen Eigenschaft (property) für den Security-Provider.

objectbound Isom.Base.Boolean Isom.Security.SecurityProvider.SetProp  ( Isom.Base.String  propName,
Isom.Base.String  propValue  )

Setzt den Wert der vorgegebenen Eigenschaft (property) für den Security-Provider.

Die systemseitig ermittelten Eigenschaftsnamen sind in den herstellerspezifischen Begleitdokumenten zu finden.

   using Isom.Base.* 
   ... 
      SecurityProvider provider = ...; 
      String propName = "PropertyName"; 
      if( provider.GetProp(propName).IsVoid() ) 
        provider.SetProp( propName, "PropertyValue" ); 
Rückgabe:
'true' nach erfolgreichem Setzen, 'false' niemals.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls das Steuergeräteobjekt Teil der Ist-Sg-Liste ist und die Eigenschaft bereits nicht leer gesetzt ist.
Isom.Security.SecurityProvider.Void

Erzeugt ein ungültiges Objekt.

Isom.Security.SecurityProvider Isom.Security.SecurityProvider.Void  (  ) 

Erzeugt ein ungültiges Objekt.

Die Funktion kann in Fehlerfällen verwendet werden, um z.B. einen ungültigen Funktionsrückgabewert zu erzeugen.

Rückgabe:
Ungültiges Objekt.

Version 9.10.1.0 vom 25 November 2013