X-Git-Url: http://git.silcnet.org/gitweb/?p=website.git;a=blobdiff_plain;f=docs%2Ftoolkit%2Fmanual%2Fsilcclient-silc_client_add_channel_private_key.html;fp=docs%2Ftoolkit%2Fmanual%2Fsilcclient-silc_client_add_channel_private_key.html;h=65da6c8759170ec7754aea2c6946ab188ca04269;hp=0000000000000000000000000000000000000000;hb=80b80cef93d9dff6acc4bc8e3a522c55fcdc3fca;hpb=43e53f529ca5c7d2ddb7cee8e76e273631e6f1e2 diff --git a/docs/toolkit/manual/silcclient-silc_client_add_channel_private_key.html b/docs/toolkit/manual/silcclient-silc_client_add_channel_private_key.html new file mode 100644 index 0000000..65da6c8 --- /dev/null +++ b/docs/toolkit/manual/silcclient-silc_client_add_channel_private_key.html @@ -0,0 +1,321 @@ + + + + + + + + + + + + + + + + + + + +
Copyright © 2001 - 2007 SILC Project
+ SILC Project Website		 + SILC Toolkit Reference Manual
+ Index
+ + +
+ + + + + + + + + + + + + + +
+ + + +
+
+ + + +SILC Toolkit Reference Manual
+ + +SILC Crypto Library
+    Introduction to SILC RNG
+    SILC RNG Interface
+    SILC Cipher API
+    SILC PKCS API
+    SILC Public Key API
+    SILC PKCS #1 API
+    SILC Hash Interface
+    SILC HMAC Interface
+SILC Core Library
+    SILC Authentication Interface
+    SILC Message Interface
+    SILC Channel Interface
+    SILC Command Interface
+    SILC Notify Interface
+    SILC Status Types
+    SILC Modes
+    SILC ID Interface
+    SILC Argument Interface
+    SILC Attributes Interface
+    Packet Engine Interface
+    SILC Public Key Payload Interface
+SILC Key Exchange Library
+    SILC SKE Interface
+    SILC Connection Authentication Interface
+SILC VCard Library
+    SILC VCard Interface
+SILC Math Library
+    SILC MP Interface
+    SILC Math Interface
+SILC Client Library
+    Using SILC Client Library Tutorial
+    Arguments for command_reply Client Operation
+    SilcStatus Error Arguments in command_reply Client Operation
+    Arguments for notify Client Operation
+    Unicode and UTF-8 Strings in Client Library
+    Client Library Interface Reference
+    Client Entry Interface Reference
+SILC ASN.1 Library
+    SILC ASN.1 Interface
+    SILC BER interface
+SILC HTTP Library
+    SILC HTTP Server Interface
+    SILC HTTP PHP Translator
+SILC Utility Library
+    Basic Types and Definitions
+    Data Buffer Interface
+    Data Buffer Format Interface
+    Hash Table Interface
+    Memory Allocation Interface
+    Data Stack (memory pool) Interface
+    Finite State Machine Interface
+    Thread Interface
+    Mutual Exclusion Lock Interface
+    Condition Variable Interface
+    Atomic Operations Interface
+    Network (TCP and UDP) Interface
+    Scheduler Interface
+    Asynchronous Operation Interface
+    Abstract Stream Interface
+    Socket Stream Interface
+    File Descriptor Stream Interface
+    File Utility Functions
+    String Utility Interface
+    Snprintf Interface
+    UTF-8 String Interface
+    Stringprep Interface
+    Utility Functions
+    List Interface
+    Dynamic List Interface
+    MIME Interface
+    Time Utility Functions
+    Logging Interface
+    Config File Interface
+SILC Key Repository Library
+    SILC SKR Interface
+SILC Application Utility Library
+    SILC Application Utilities
+    SILC ID Cache Interface
+SILC SFTP Library
+    SILC SFTP Interface
+    SFTP Filesystems Interface
+ +
+Resource Links +
+SILC Project Website
+SILC Protocol Documentation
+SILC White Paper
+SILC FAQs
+ + +



+
+ 		+ + + + +
+
+ +Function silc_client_add_channel_private_key

+ + +SYNOPSIS + +

+    SilcBool
+    silc_client_add_channel_private_key(SilcClient client,
+                                        SilcClientConnection conn,
+                                        SilcChannelEntry channel,
+                                        const char *name,
+                                        char *cipher,
+                                        char *hmac,
+                                        unsigned char *key,
+                                        SilcUInt32 key_len,
+                                        SilcChannelPrivateKey *ret_key);
+
+
+DESCRIPTION + +

+    Adds private key for channel. When channel has private key then the
+    messages are encrypted using that key. All clients on the channel
+    must also know the key in order to decrypt the messages. However,
+    it is possible to have several private keys per one channel. In this
+    case only some of the clients on the channel may know the one key
+    and only some the other key.  The `name' can be application given
+    name for the key.  This returns the created key to the 'ret_key'
+    pointer if it is non-NULL;
+
+    If `cipher' and/or `hmac' is NULL then default values will be used
+    (aes-256-cbc for cipher and hmac-sha1-96 for hmac).
+
+    The private key for channel is optional. If it is not set then the
+    channel messages are encrypted using the channel key generated by the
+    server. However, setting the private key (or keys) for the channel
+    significantly adds security. If more than one key is set the library
+    will automatically try all keys at the message decryption phase. Note:
+    setting many keys slows down the decryption phase as all keys has to
+    be tried in order to find the correct decryption key. However, setting
+    a few keys does not have big impact to the decryption performace.
+
+
+NOTES + +

+    NOTE: This is entirely local setting. The key set using this function
+    is not sent to the network at any phase.
+
+    NOTE: If the key material was originated by the SKE protocol (using
+    silc_client_send_key_agreement) then the `key' MUST be the
+    key->send_enc_key as this is dictated by the SILC protocol. However,
+    currently it is not expected that the SKE key material would be used
+    as channel private key. However, this API allows it.
+
+
+



+
+ 		+ + + + +
+
+ +Client Library Interface
+SilcClientConnectionStatus
+SilcClientRunning
+SilcClientStopped
+SilcClientConnectCallback
+SilcClient
+SilcClientConnection
+SilcChannelUser
+SilcClientStats
+SilcKeyAgreementStatus
+SilcKeyAgreementCallback
+SilcPrivateMessageKeys
+SilcChannelPrivateKey
+SilcAskPassphrase
+SilcVerifyPublicKey
+SilcGetAuthMeth
+SilcClientMessageType
+SilcClientOperations
+SilcClientParams
+silc_client_alloc
+silc_client_free
+silc_client_init
+silc_client_run
+silc_client_run_one
+silc_client_stop
+SilcClientConnectionParams
+silc_client_connect_to_server
+silc_client_connect_to_client
+silc_client_key_exchange
+silc_client_close_connection
+silc_client_send_channel_message
+silc_client_send_private_message
+silc_client_private_message_wait_init
+silc_client_private_message_wait_uninit
+silc_client_private_message_wait
+silc_client_on_channel
+silc_client_command_call
+SilcClientCommandReply
+silc_client_command_send
+silc_client_command_pending
+silc_client_add_private_message_key
+silc_client_add_private_message_key_ske
+silc_client_del_private_message_key
+silc_client_list_private_message_keys
+silc_client_free_private_message_keys
+silc_client_private_message_key_is_set
+silc_client_add_channel_private_key
+silc_client_del_channel_private_keys
+silc_client_del_channel_private_key
+silc_client_list_channel_private_keys
+silc_client_current_channel_private_key
+silc_client_send_key_agreement
+silc_client_perform_key_agreement
+silc_client_perform_key_agreement_stream
+silc_client_abort_key_agreement
+silc_client_set_away_message
+SilcClientMonitorStatus
+SilcClientFileError
+SilcClientFileMonitor
+SilcClientFileName
+SilcClientFileAskName
+silc_client_file_send
+silc_client_file_receive
+silc_client_file_close
+silc_client_attribute_add
+silc_client_attribute_del
+silc_client_attributes_get
+silc_client_attributes_request
+silc_client_nickname_format
+silc_client_nickname_parse
+ + +



+
+
+ + + +
+ + + + + + +
Copyright © 2001 - 2007 SILC Project
+ SILC Project Website		 + SILC Toolkit Reference Manual
+ Index
+ + +