Class KeyRingUtils

    • Method Summary

      All Methods Static Methods Concrete Methods Deprecated Methods 
      Modifier and Type Method Description
      static org.bouncycastle.openpgp.PGPPublicKeyRing deleteUserId​(org.bouncycastle.openpgp.PGPPublicKeyRing publicKeys, String userId)
      Deprecated.
      Deleting user-ids is highly discouraged, since it might lead to all sorts of problems (e.g. lost key properties).
      static org.bouncycastle.openpgp.PGPSecretKeyRing deleteUserId​(org.bouncycastle.openpgp.PGPSecretKeyRing secretKeys, String userId)
      Deprecated.
      Deleting user-ids is highly discouraged, since it might lead to all sorts of problems (e.g. lost key properties).
      static org.bouncycastle.openpgp.PGPPublicKey getPrimaryPublicKeyFrom​(org.bouncycastle.openpgp.PGPKeyRing keyRing)
      Return the primary PGPPublicKey from the provided key ring or null if it has none.
      static org.bouncycastle.openpgp.PGPSecretKey getPrimarySecretKeyFrom​(org.bouncycastle.openpgp.PGPSecretKeyRing secretKeys)
      Return the primary PGPSecretKey from the provided PGPSecretKeyRing or null if it has none.
      static org.bouncycastle.openpgp.PGPPublicKey getPublicKeyFrom​(org.bouncycastle.openpgp.PGPKeyRing keyRing, long subKeyId)  
      static <T extends org.bouncycastle.openpgp.PGPKeyRing>
      T
      injectCertification​(T keyRing, String userId, org.bouncycastle.openpgp.PGPSignature certification)  
      static <T extends org.bouncycastle.openpgp.PGPKeyRing>
      T
      injectCertification​(T keyRing, org.bouncycastle.openpgp.PGPPublicKey certifiedKey, org.bouncycastle.openpgp.PGPSignature certification)  
      static <T extends org.bouncycastle.openpgp.PGPKeyRing>
      T
      injectCertification​(T keyRing, org.bouncycastle.openpgp.PGPUserAttributeSubpacketVector userAttributes, org.bouncycastle.openpgp.PGPSignature certification)  
      static boolean keyRingContainsKeyWithId​(org.bouncycastle.openpgp.PGPPublicKeyRing ring, long keyId)  
      static org.bouncycastle.openpgp.PGPPublicKeyRingCollection keyRingsToKeyRingCollection​(org.bouncycastle.openpgp.PGPPublicKeyRing... rings)  
      static org.bouncycastle.openpgp.PGPSecretKeyRingCollection keyRingsToKeyRingCollection​(org.bouncycastle.openpgp.PGPSecretKeyRing... rings)  
      static <T extends org.bouncycastle.openpgp.PGPKeyRing>
      T
      keysPlusPublicKey​(T keyRing, org.bouncycastle.openpgp.PGPPublicKey publicKey)  
      static org.bouncycastle.openpgp.PGPSecretKeyRing keysPlusSecretKey​(org.bouncycastle.openpgp.PGPSecretKeyRing secretKeys, org.bouncycastle.openpgp.PGPSecretKey secretKey)  
      static org.bouncycastle.openpgp.PGPPublicKeyRing publicKeyRingFrom​(org.bouncycastle.openpgp.PGPSecretKeyRing secretKeys)
      Extract a PGPPublicKeyRing containing all public keys from the provided PGPSecretKeyRing.
      static org.bouncycastle.openpgp.PGPPublicKey requirePrimaryPublicKeyFrom​(org.bouncycastle.openpgp.PGPKeyRing keyRing)
      Return the primary PGPPublicKey from the provided key ring.
      static org.bouncycastle.openpgp.PGPSecretKey requirePrimarySecretKeyFrom​(org.bouncycastle.openpgp.PGPSecretKeyRing secretKeys)
      Return the primary PGPSecretKey from the provided PGPSecretKeyRing.
      static org.bouncycastle.openpgp.PGPPublicKey requirePublicKeyFrom​(org.bouncycastle.openpgp.PGPKeyRing keyRing, long subKeyId)  
      static org.bouncycastle.openpgp.PGPSecretKey requireSecretKeyFrom​(org.bouncycastle.openpgp.PGPSecretKeyRing keyRing, long subKeyId)  
      static org.bouncycastle.openpgp.PGPSecretKey secretKeyPlusSignature​(org.bouncycastle.openpgp.PGPSecretKey secretKey, org.bouncycastle.openpgp.PGPSignature signature)  
      static org.bouncycastle.openpgp.PGPPrivateKey unlockSecretKey​(org.bouncycastle.openpgp.PGPSecretKey secretKey, SecretKeyRingProtector protector)
      Unlock a PGPSecretKey and return the resulting PGPPrivateKey.
    • Method Detail

      • requirePrimarySecretKeyFrom

        public static org.bouncycastle.openpgp.PGPSecretKey requirePrimarySecretKeyFrom​(org.bouncycastle.openpgp.PGPSecretKeyRing secretKeys)
        Return the primary PGPSecretKey from the provided PGPSecretKeyRing. If it has no primary secret key, throw a NoSuchElementException.
        Parameters:
        secretKeys - secret keys
        Returns:
        primary secret key
      • getPrimarySecretKeyFrom

        public static org.bouncycastle.openpgp.PGPSecretKey getPrimarySecretKeyFrom​(org.bouncycastle.openpgp.PGPSecretKeyRing secretKeys)
        Return the primary PGPSecretKey from the provided PGPSecretKeyRing or null if it has none.
        Parameters:
        secretKeys - secret key ring
        Returns:
        primary secret key
      • requirePrimaryPublicKeyFrom

        public static org.bouncycastle.openpgp.PGPPublicKey requirePrimaryPublicKeyFrom​(org.bouncycastle.openpgp.PGPKeyRing keyRing)
        Return the primary PGPPublicKey from the provided key ring. Throws a NoSuchElementException if the key ring has no primary public key.
        Parameters:
        keyRing - key ring
        Returns:
        primary public key
      • getPrimaryPublicKeyFrom

        public static org.bouncycastle.openpgp.PGPPublicKey getPrimaryPublicKeyFrom​(org.bouncycastle.openpgp.PGPKeyRing keyRing)
        Return the primary PGPPublicKey from the provided key ring or null if it has none.
        Parameters:
        keyRing - key ring
        Returns:
        primary public key
      • getPublicKeyFrom

        public static org.bouncycastle.openpgp.PGPPublicKey getPublicKeyFrom​(org.bouncycastle.openpgp.PGPKeyRing keyRing,
                                                                             long subKeyId)
      • requirePublicKeyFrom

        public static org.bouncycastle.openpgp.PGPPublicKey requirePublicKeyFrom​(org.bouncycastle.openpgp.PGPKeyRing keyRing,
                                                                                 long subKeyId)
      • requireSecretKeyFrom

        public static org.bouncycastle.openpgp.PGPSecretKey requireSecretKeyFrom​(org.bouncycastle.openpgp.PGPSecretKeyRing keyRing,
                                                                                 long subKeyId)
      • publicKeyRingFrom

        public static org.bouncycastle.openpgp.PGPPublicKeyRing publicKeyRingFrom​(org.bouncycastle.openpgp.PGPSecretKeyRing secretKeys)
        Extract a PGPPublicKeyRing containing all public keys from the provided PGPSecretKeyRing.
        Parameters:
        secretKeys - secret key ring
        Returns:
        public key ring
      • unlockSecretKey

        public static org.bouncycastle.openpgp.PGPPrivateKey unlockSecretKey​(org.bouncycastle.openpgp.PGPSecretKey secretKey,
                                                                             SecretKeyRingProtector protector)
                                                                      throws org.bouncycastle.openpgp.PGPException
        Unlock a PGPSecretKey and return the resulting PGPPrivateKey.
        Parameters:
        secretKey - secret key
        protector - protector to unlock the secret key
        Returns:
        private key
        Throws:
        org.bouncycastle.openpgp.PGPException - if something goes wrong (eg. wrong passphrase)
      • keyRingsToKeyRingCollection

        public static org.bouncycastle.openpgp.PGPPublicKeyRingCollection keyRingsToKeyRingCollection​(@Nonnull
                                                                                                      org.bouncycastle.openpgp.PGPPublicKeyRing... rings)
                                                                                               throws IOException,
                                                                                                      org.bouncycastle.openpgp.PGPException
        Throws:
        IOException
        org.bouncycastle.openpgp.PGPException
      • keyRingsToKeyRingCollection

        public static org.bouncycastle.openpgp.PGPSecretKeyRingCollection keyRingsToKeyRingCollection​(@Nonnull
                                                                                                      org.bouncycastle.openpgp.PGPSecretKeyRing... rings)
                                                                                               throws IOException,
                                                                                                      org.bouncycastle.openpgp.PGPException
        Throws:
        IOException
        org.bouncycastle.openpgp.PGPException
      • deleteUserId

        @Deprecated
        public static org.bouncycastle.openpgp.PGPSecretKeyRing deleteUserId​(org.bouncycastle.openpgp.PGPSecretKeyRing secretKeys,
                                                                             String userId)
        Deprecated.
        Deleting user-ids is highly discouraged, since it might lead to all sorts of problems (e.g. lost key properties). Instead, user-ids should only be revoked.
        Delete the given user-id and its certification signatures from the given key.
        Parameters:
        secretKeys - secret keys
        userId - user-id
        Returns:
        modified secret keys
      • deleteUserId

        @Deprecated
        public static org.bouncycastle.openpgp.PGPPublicKeyRing deleteUserId​(org.bouncycastle.openpgp.PGPPublicKeyRing publicKeys,
                                                                             String userId)
        Deprecated.
        Deleting user-ids is highly discouraged, since it might lead to all sorts of problems (e.g. lost key properties). Instead, user-ids should only be revoked.
        Delete the given user-id and its certification signatures from the given certificate.
        Parameters:
        publicKeys - certificate
        userId - user-id
        Returns:
        modified secret keys
      • injectCertification

        public static <T extends org.bouncycastle.openpgp.PGPKeyRing> T injectCertification​(T keyRing,
                                                                                            org.bouncycastle.openpgp.PGPPublicKey certifiedKey,
                                                                                            org.bouncycastle.openpgp.PGPSignature certification)
      • injectCertification

        public static <T extends org.bouncycastle.openpgp.PGPKeyRing> T injectCertification​(T keyRing,
                                                                                            String userId,
                                                                                            org.bouncycastle.openpgp.PGPSignature certification)
      • injectCertification

        public static <T extends org.bouncycastle.openpgp.PGPKeyRing> T injectCertification​(T keyRing,
                                                                                            org.bouncycastle.openpgp.PGPUserAttributeSubpacketVector userAttributes,
                                                                                            org.bouncycastle.openpgp.PGPSignature certification)
      • keysPlusPublicKey

        public static <T extends org.bouncycastle.openpgp.PGPKeyRing> T keysPlusPublicKey​(T keyRing,
                                                                                          org.bouncycastle.openpgp.PGPPublicKey publicKey)
      • keysPlusSecretKey

        public static org.bouncycastle.openpgp.PGPSecretKeyRing keysPlusSecretKey​(org.bouncycastle.openpgp.PGPSecretKeyRing secretKeys,
                                                                                  org.bouncycastle.openpgp.PGPSecretKey secretKey)
      • secretKeyPlusSignature

        public static org.bouncycastle.openpgp.PGPSecretKey secretKeyPlusSignature​(org.bouncycastle.openpgp.PGPSecretKey secretKey,
                                                                                   org.bouncycastle.openpgp.PGPSignature signature)