CKTIS / Java
GCMParameterSpec — parameters voor de GCM-modus
GCMParameterSpec geeft een Cipher een initialisatievector en de lengte van de authenticatietag. Het object versleutelt zelf geen gegevens en garandeert niet dat de IV uniek is.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
public GCMParameterSpec(int tLen, byte[] src)
public GCMParameterSpec(int tLen, byte[] src, int offset, int len)
int getTLen()
byte[] getIV()GCMParameterSpec uit javax.crypto.spec beschrijft parameters voor een Cipher in de GCM-modus. tLen geeft de lengte van de authenticatietag op in bits, niet in bytes; het is niet de sleutellengte.
Een constructor accepteert de volledige IV of een deel van src, geselecteerd met offset en len in bytes. De invoer wordt gekopieerd; ook getIV() retourneert een nieuwe kopie. getTLen() retourneert de taglengte.
Een negatieve tLen, null of ongeldige grenzen van de deelreeks veroorzaken IllegalArgumentException. Dat het object wordt aangemaakt, garandeert niet dat een cryptografische provider de gekozen taglengte ondersteunt.
Geef deze parameters voor AES/GCM/NoPadding door aan Cipher.init(...). Gebruik bij versleuteling met dezelfde sleutel nooit een IV opnieuw: dat maakt vervalsingsaanvallen mogelijk. Het voorbeeld laat alleen zien hoe arrays worden gekopieerd, niet hoe je veilig een IV genereert.
Voorbeelden
import javax.crypto.spec.GCMParameterSpec;
public class Main {
public static void main(String[] args) {
byte[] iv = new byte[12];
iv[0] = 7;
GCMParameterSpec spec = new GCMParameterSpec(128, iv);
iv[0] = 9;
byte[] copy = spec.getIV();
copy[0] = 11;
System.out.println(spec.getTLen());
System.out.println(spec.getIV().length);
System.out.println(spec.getIV()[0]);
}
}Resultaat
128 12 7
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.