Copyright © 2001 - 2002 SILC Project SILC Project Website | SILC Toolkit Reference Manual

SILC Toolkit Reference Manual SILC Core Library SILC Authentication Interface SILC Channel Interface SILC Command Interface SILC ID Interface SILC ID Cache Interface SILC Modes SILC Notify Interface SILC Argument Interface SILC Private Message Interface Packet Protocol Interface SILC Math Library SILC MP Interface SILC Math Interface SILC SFTP Library SILC SFTP Interface SFTP Filesystems Interface SILC Utility Library SILC Buffer Interface SILC Buffer Format Interface SILC Hash Table Interface SILC Logging Interface SILC Memory Interface SILC Mutex Interface SILC Thread Interface SILC Network Interface SILC Schedule Interface SILC Socket Interface SILC Protocol Interface SILC Config Interface SILC File Util Interface SILC Util Interface SILC List Interface SILC Dynamic List Interface SILC Zip API SILC Key Exchange Library SILC SKE Interface SKE Status Types SKE Diffie Hellman Groups SKE Payloads SILC Client Library Using SILC Client Library Client Library Interface SILC Crypto Library Introduction to SILC RNG SILC RNG Interface SILC HMAC Interface SILC Cipher API SILC Hash API SILC PKCS API Resource Links SILC Project Website SILC Protocol Documentation SILC White Paper SILC FAQ
Function silc_client_add_channel_private_key SYNOPSIS
        int 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);
DESCRIPTION
        Adds private key for channel. This may be set only if the channel's mode
        mask includes the SILC_CHANNEL_MODE_PRIVKEY. This returns FALSE if the
        mode is not set. 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.

        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 SilcKeyAgreementStatus SilcKeyAgreementCallback SilcPrivateMessageKeys SilcChannelPrivateKey SilcAskPassphrase SilcVerifyPublicKey SilcGetAuthMeth SilcClientMessageType SilcClientOperations SilcNicknameFormatParse SilcClientParams silc_client_alloc silc_client_free silc_client_init silc_client_run silc_client_run_one silc_client_stop silc_client_connect_to_server silc_client_add_connection silc_client_del_connection silc_client_add_socket silc_client_del_socket silc_client_start_key_exchange silc_client_close_connection silc_client_send_channel_message silc_client_send_private_message SilcGetClientCallback silc_client_get_clients silc_client_get_clients_local silc_client_get_clients_by_list silc_client_get_client_by_id silc_client_get_client_by_id_resolve silc_client_del_client SilcGetChannelCallback silc_client_get_channel silc_client_get_channel_id_resolve silc_client_get_channel_by_id_resolve silc_client_del_channel silc_client_get_server silc_client_get_server_by_id silc_client_del_server silc_client_on_channel silc_client_command_alloc silc_client_command_free silc_client_command_dup silc_client_command_find silc_client_command_call silc_client_command_send silc_client_command_pending silc_client_add_private_message_key silc_client_add_private_message_key_ske silc_client_send_private_message_key silc_client_del_private_message_key silc_client_list_private_message_keys silc_client_free_private_message_keys 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_free_channel_private_keys silc_client_current_channel_private_key silc_client_send_key_agreement silc_client_perform_key_agreement silc_client_perform_key_agreement_fd silc_client_abort_key_agreement silc_client_set_away_message SilcConnectionAuthRequest silc_client_request_authentication_method SilcClientMonitorStatus SilcClientFileError SilcClientFileMonitor silc_client_file_send silc_client_file_receive silc_client_file_close

Copyright © 2001 - 2002 SILC Project SILC Project Website | SILC Toolkit Reference Manual