2019-08-22 20:49:30 +08:00
<?xml version="1.0" encoding="UTF-8" ?>
2020-02-01 09:03:48 +08:00
<class name= "CryptoKey" inherits= "Resource" version= "4.0" >
2019-08-22 20:49:30 +08:00
<brief_description >
2019-09-24 00:16:41 +08:00
A cryptographic key (RSA).
2019-08-22 20:49:30 +08:00
</brief_description>
<description >
2019-09-24 00:16:41 +08:00
The CryptoKey class represents a cryptographic key. Keys can be loaded and saved like any other [Resource].
2019-09-28 04:16:32 +08:00
They can be used to generate a self-signed [X509Certificate] via [method Crypto.generate_self_signed_certificate] and as private key in [method StreamPeerSSL.accept_stream] along with the appropriate certificate.
2020-01-14 20:54:31 +08:00
[b]Note:[/b] Not available in HTML5 exports.
2019-08-22 20:49:30 +08:00
</description>
<tutorials >
</tutorials>
<methods >
2020-06-18 18:39:56 +08:00
<method name= "is_public_only" qualifiers= "const" >
<return type= "bool" >
</return>
<description >
Return [code]true[/code] if this CryptoKey only has the public part, and not the private one.
</description>
</method>
2019-08-22 20:49:30 +08:00
<method name= "load" >
<return type= "int" enum= "Error" >
</return>
<argument index= "0" name= "path" type= "String" >
</argument>
2020-06-18 18:39:56 +08:00
<argument index= "1" name= "public_only" type= "bool" default= "false" >
</argument>
<description >
Loads a key from [code]path[/code]. If [code]public_only[/code] is [code]true[/code], only the public key will be loaded.
2021-03-18 19:04:28 +08:00
[b]Note[/b]: [code]path[/code] should be a "*.pub" file if [code]public_only[/code] is [code]true[/code], a "*.key" file otherwise.
2020-06-18 18:39:56 +08:00
</description>
</method>
<method name= "load_from_string" >
<return type= "int" enum= "Error" >
</return>
<argument index= "0" name= "string_key" type= "String" >
</argument>
<argument index= "1" name= "public_only" type= "bool" default= "false" >
</argument>
2019-08-22 20:49:30 +08:00
<description >
2020-06-18 18:39:56 +08:00
Loads a key from the given [code]string[/code]. If [code]public_only[/code] is [code]true[/code], only the public key will be loaded.
2019-08-22 20:49:30 +08:00
</description>
</method>
<method name= "save" >
<return type= "int" enum= "Error" >
</return>
<argument index= "0" name= "path" type= "String" >
</argument>
2020-06-18 18:39:56 +08:00
<argument index= "1" name= "public_only" type= "bool" default= "false" >
</argument>
<description >
Saves a key to the given [code]path[/code]. If [code]public_only[/code] is [code]true[/code], only the public key will be saved.
2021-03-18 19:04:28 +08:00
[b]Note[/b]: [code]path[/code] should be a "*.pub" file if [code]public_only[/code] is [code]true[/code], a "*.key" file otherwise.
2020-06-18 18:39:56 +08:00
</description>
</method>
<method name= "save_to_string" >
<return type= "String" >
</return>
<argument index= "0" name= "public_only" type= "bool" default= "false" >
</argument>
2019-08-22 20:49:30 +08:00
<description >
2020-06-18 18:39:56 +08:00
Returns a string containing the key in PEM format. If [code]public_only[/code] is [code]true[/code], only the public key will be included.
2019-08-22 20:49:30 +08:00
</description>
</method>
</methods>
<constants >
</constants>
</class>