Infoblox::Grid::X509Certificate - An X509Certificate object.

• NAME
• DESCRIPTION
• CONSTRUCTOR
• SESSION METHODS
• Infoblox::Session->get( )
• Infoblox::Session->remove( )
• Infoblox::Session->search( )
• METHODS
• issuer( )
• serial( )
• distinguished_name( )
• valid_not_before( )
• valid_not_after( )
• AUTHOR
• SEE ALSO
• COPYRIGHT

NAME

Infoblox::Grid::X509Certificate - An X509Certificate object.

DESCRIPTION

An X509Certificate object.

CONSTRUCTOR

SESSION METHODS

This section describes all the methods in an Infoblox::Session module that you can apply to an X509Certificate object.

Infoblox::Session->get( )

Use this method to retrieve all the matching objects from the Infoblox appliance. See Infoblox::Session->get() for parameters and return values.

Key References

 Apply the following attributes to get for an X509Certificate object:

  serial              - Optional. The certificate serial number in hex format.
  issuer              - Optional. The name of the issuer.
  distinguished_name  - Optional. The certificate subject name.
  valid_not_after     - Optional. String that contains a desired value of the certificate expiration date in ISO 8601 format.
  valid_not_before    - Optional. String that contains a desired value of the certificate start date in ISO 8601 format.

Example

 # Retrieve X509Certificate objects with specify certificate subject name
 my @retrieved_objs = $session->get(
        object             => 'Infoblox::Grid::X509Certificate',
        distinguished_name => 'CN="10.34.1.106",OU="Engineering",O="Infoblox Inc",L="Santa Clara",ST="California",C="US"',
 );

Infoblox::Session->remove( )

Use this method to remove an object from the Infoblox appliance. See Infoblox::Session->remove() for parameters and return values.

To remove a specific object, first use get() or search() to retrieve the specific object, and then submit this object for removal.

Example

 # Get X509Certificate object
 my @retrieved_objs = $session->get(
        object             => 'Infoblox::Grid::X509Certificate',
        distinguished_name => 'CN="10.34.1.106",OU="Engineering",O="Infoblox Inc",L="Santa Clara",ST="California",C="US"',
 );

 # Find the desired object from the retrieved list
 my $x509cert = $retrieved_objs[0];

 # Submit for removal
 my $response = $session->remove( $x509cert );

Infoblox::Session->search( )

Use this method to search for objects in the Infoblox appliance. See Infoblox::Session->search() for parameters and return values.

Key References

 Apply the following attributes to search for an X509Certificate object:

  serial              - Optional. The certificate serial number in hex format.
  issuer              - Optional. The name of the issuer.
  distinguished_name  - Optional. The certificate subject name.
  valid_not_after     - Optional. String that contains a desired value of the certificate expiration date in ISO 8601 format.
  valid_not_before    - Optional. String that contains a desired value of the certificate start date in ISO 8601 format.

Example

 # Retrieve X509Certificate objects with specify certificate subject name
 my @retrieved_objs = $session->search(
        object             => 'Infoblox::Grid::X509Certificate',
        distinguished_name => 'CN="10.34.1.106",OU="Engineering",O="Infoblox Inc",L="Santa Clara",ST="California",C="US"',
 );

METHODS

This section describes all the methods that you can use to configure and retrieve the attribute values of a X509Certificate object.

issuer( )

Use this method to retrieve the issuer subject name. This method does not support any argument because the attribute is read-only and is set by the server.

Parameter

None

Returns

The method returns the attribute value.

Example

 # Get attribute value
 my $issuer = $x509cert->issuer();

serial( )

Use this method to retrieve the certificate serial number in hex format. This method does not support any argument because the attribute is read-only and is set by the server.

Parameter

None

Returns

The method returns the attribute value.

Example

 # Get attribute value
 my $serial = $x509cert->serial();

distinguished_name( )

Use this method to retrieve the certificate subject name. This method does not support any argument because the attribute is read-only and is set by the server.

Parameter

None

Returns

The method returns the attribute value.

Example

 # Get attribute value
 my $distinguished_name = $x509cert->distinguished_name();

valid_not_before( )

Use this method to retrieve the date before the certificate becomes invalid in ISO 8601 format. This method does not support any argument because the attribute is read-only and is set by the server.

Parameter

None

Returns

The method returns the attribute value.

Example

 # Get attribute value
 my $valid_not_before = $x509cert->valid_not_before();

valid_not_after( )

Use this method to retrieve the date after the certificate becomes invalid in ISO 8601 format. This method does not support any argument because the attribute is read-only and is set by the server.

Parameter

None

Returns

The method returns the attribute value.

Example

 # Get attribute value
 my $valid_not_after = $x509cert->valid_not_after();

AUTHOR

Infoblox Inc. http://www.infoblox.com/

SEE ALSO

Infoblox::Session

COPYRIGHT

Copyright (c) 2017 Infoblox Inc.