GCM-baserade funktioner new-functions

För att förbättra säkerheten har AES-algoritmen (Advanced Encryption Standard) med CBC-läget (Cipher Block Chaining) för kryptografiska operationer tagits bort. Nya krypteringsfunktioner har införts. Dessa funktioner använder AES med Galois/Counter Mode (AES-GCM), vilket ger ett säkrare alternativ. Dessa funktioner är tillgängliga i JavaScript, JSP, SOAP API:er och XML-scheman, vilket gör att kunder kan gå över från CBC till GCM för kryptering och dekryptering.

I den här dokumentationen listas de nyligen introducerade AES-GCM-funktionerna och de CBC-baserade funktionerna som tas bort.

Nya funktioner:

Äldre funktioner som kan användas för GCM:

Föråldrade funktioner

API-funktioner

EncryptString encryptString-api-xtk

Krypterar teckensträngen med instansnyckeln med AES-algoritmen med GCM-läget.

            String
            encrypted = EncryptString (
            String
            decrypted


      )

Parametrar: Dekrypterad text

Returvärden: krypterade

Schema: xtk:session

Statisk: Ja

EncryptStringWithServerPassword EncryptStringWithServerPassword-api-xtk

Krypterar teckensträngen med servernyckeln med hjälp av AES-algoritmen med GCM-läge.

            String
            encrypted = EncryptStringWithServerPassword (
            String
            decrypted


      )

Parametrar: Dekrypterad

Returvärden: krypterade

Schema: xtk:session

Statisk: Ja

Javascript-funktioner

encryptString() encryptString-javascript

Krypterar en teckensträng med nyckeln för instansen eller någon annan nyckel.

            encryptString (str [, key
      ] [, useSalt ])

Parametrar:

Returvärde: Returnerar den krypterade teckensträngen.

Anmärkningar

Kryptering utförs enligt följande metod:

Dekrypteringen utförs med funktionen dekrypptString.

Funktioner

Finns i:

decryptString() decryptString-javascript

Dekrypterar en teckensträng med instansnyckeln eller någon annan tangent. Den här gamla funktionen kan användas med GCM. Den används inte för dekryptering av chiffertext som krypteras i AES-CBC-läge.

            decryptString (str [, key
      ] [, useSalt ])

Parametrar:

Returvärde: Returnerar den dekrypterade teckensträngen.

Varning: Lösenord som lagras i databasen (alternativ/externa konton) kan inte längre dekrypteras med den här metoden. Använd decryptPassword för det.

decryptPassword() decryptPassword-javascript

Dekrypterar ett lösenord som lagras i ett externt konto. Den här gamla funktionen kan användas med GCM. Den används inte för dekryptering av chiffertext som krypteras i AES-CBC-läge.

            decryptPassword (str)

Parametrar:

Returvärde: Returnerar lösenord med oformaterad text.

Anmärkningar

Den här funktionen kan inte anropas i arbetsflöden, webbprogram, rapporter eller leveranser. Den kan anropas i JSSP- eller SOAP-samtalsimplementeringar. Exempel:

        function nms_extAccount_LogonToRemoteInstance(remoteInstanceUrl, login, encryptedPassword) {
        var cnx = null, sessionService = null;
        try
            {
                var cnx = new HttpSoapConnection(remoteInstanceUrl + '/nl/jsp/soaprouter.jsp', 'utf-8', 0);
                sessionService = new SoapService(cnx, 'xtk:session');
                sessionService.addMethod("Logon", "xtk:session#Logon",
                    ["token", "string", "login", "string", "password", "string", "parameters", "NLElement"],
                    ["sessionToken", "string", "sessionInfo", "NLElement", "securityToken", "string"]);
                return sessionService.Logon("", login, decryptPassword(encryptedPassword), <parameters/>);
            }
        catch( e ) {
        logError(e);
        }
        finally {
        if( sessionService ) sessionService.dispose();
        if( cnx ) cnx.dispose();
        }
        })

Föråldrade funktioner depracated-functions

Följande funktioner är helt inaktuella: