[[TOC()]]

= [wiki:help/en Cyberduck Help] / [wiki:help/en/howto Howto] / Connection Profiles =

[wiki:help/en/howto/connection#ConnectionProfiles Connection profiles] (`.cyberduckprofile`) are documents describing specific connection settings for a hosting provider. 
 * [http://trac.cyberduck.ch/wiki/help/en/howto/s3#Third-PartyS3providers Third-Party S3 providers]
 * [http://trac.cyberduck.ch/wiki/help/en/howto/openstack#Providers OpenStack Providers]

These files ([http://en.wikipedia.org/wiki/Property_list XML Property List Format]) can be created for customers to make it easier to connect with a double click on that file without entering the connection details manually.

 [mailto:support@cyberduck.io Contact us] if you are a service provider and need assistance in setting this up.

== Technical file format specification ==

Connection profile files are ([http://en.wikipedia.org/wiki/Property_list XML Property List Format]) can be created for customers to make it easier to connect with a double click on that file without entering the connection details manually.

 [mailto:support@cyberduck.io Contact us] if you are a service provider and need assistance in setting this up.

The following properties can be defined in a connection profile:
 * `Protocol` ''(Required)''
 * `Vendor` (Hosting Provider) ''(Required)''. '''Important: This value must be unique among all installed connection profiles'''.
 * `Description`. ''(Required)''
 * `Default Nickname`.
 * `Default Hostname`. 
 * `Default Port`.
 * `Default Path`.
 * `Username Placeholder`.
 * `Password Placeholder`.
 * `Disk`. Base64 encoded disk TIFF image icon. Multi Page TIFF with formats `64x64` (72dpi) and `128x128` (144dpi) pixels. Use the [https://svn.cyberduck.ch/trunk/profiles/assets/Template.psd disk template file] to create a provider profile image.
 * `Context`. Login context path (currently used for Swift profiles)
* `Username Configurable`. Boolean if username is configurable.
* `Password Configurable`. Boolean if password is configurable.
 * `Hostname Configurable`. Boolean if hostname is configurable.
 * `Port Configurable`. Boolean if port number is configurable.
 * `Anonymous Configurable`. Boolean if anonymous access is configurable.
 * `Path Configurable`. Boolean if default path is configurable.
 * `Certificate Configurable`. Boolean if client certificate is configurable.
 * `Region`. Region name to limit listing containers of a specific region only for [wiki:en/howto/openstack OpenStack Swift] and [wiki:en/howto/s3 S3] profiles. For S3, this value us used for AWS4 signatures when no location can be deferred from the URI for thirdparty S3 providers.
 * `Regions`. List of regions supported by the provider. This will populate options in the ''Regions'' dropdown when creating a new [https://trac.cyberduck.io/wiki/help/en/howto/s3#Creatingabucket top level folder] for [wiki:en/howto/s3 S3] and [wiki:en/howto/openstack OpenStack Swift] connections.
 * `OAuth Client ID`. For protocols using OAuth 2.0 you can override the registered application client id with the provider.
 * `OAuth Client Secret`. For protocols using OAuth 2.0 you can override the registered application client secret with the provider.
 * `Authorization`. Set to `AWS2`to default to AWS2 signature authentication for S3. Default is `AWS4HMACSHA256`. 

=== Example ===


{{{
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
    <dict>
        <key>Protocol</key>
        <string>swift</string>
        <key>Vendor</key>
        <string>hp</string>
        <key>Description</key>
        <string>HP Cloud Object Storage</string>
        <key>Default Hostname</key>
        <string>region-a.geo-1.identity.hpcloudsvc.com</string>
        <key>Default Port</key>
        <string>35357</string>
        <key>Schemes</key>
        <array>
                <string>hp</string>
                <string>https</string>
        </array>
        <key>Hostname Configurable</key>
        <false/>
        <key>Port Configurable</key>
        <false/>
        <key>Context</key>
        <string>/v2.0/tokens</string>
        <key>Username Placeholder</key>
        <string>Tenant ID:Access Key</string>
        <key>Password Placeholder</key>
        <string>Secret Key</string>
        <key>Disk</key>
        <string>
            TU0AKgAFiw6AACBQOCQWDQeEQmFQuGQ2HQ+IRGJROKRWLReMRmNRuOR2PR+QSGRSOSSWTSeU
            SmVSuWS2XS+YTGZTOaTWbTecTmdTueT2fT+gUGhUOiUWjUekUmlUumU2nU+oVGpVOqVWrVes
            VmtVuuV2vV+wWGxWOyWWzWe0Wm1Wu2W23W+4XG5XO6XW7Xe8Xm9Xu+X2/X/AYHBYPCYXDYfE
            YnFYvGY3HY/IZHJZPKZXLZfMZnNZvOZ3PZ/QaHRaPSaXTafUanVavWa3Xa/YbHZbPabXbbfc
            bndbveb3fb/gcHhcPicXjcfkcnlcvmc3nc/odHpdPqdXrdfsdntdvud3vd/weHxePyeXzef0
            en1ev2e33e/4fH5fP6fX7ff8fn9fv+f3/P/AEAwFAcCQLA0DwRBMFQXBkGwdB8IQjCUJwpCs
            LQvDEMw1DcOQ7D0PxBEMRRHEkSxNE8URTFUVxZFsXRfGEYxlGcaRrG0bxxHMdR3Hkex9H8gS
            DIUhyJIsjSPHAAyUAMkSbJ0nyhKMpSmkh/ysf8qSzLUtotJcmS5MEwzFMcyTLMMryxM01TXE
            cvIZNyNzhNk5zpOs7TvPDfzQjk9onPs80BQL0TkgtCIJQlDIHRKDApRoXgPSAIA4DgNh8glJ
            g2H6EUaCwXAQBADghKyBSUiVRgBUqs1PVKGSvVFWJ3NNUVNNNYM1VcvrLWVcoHXCDV8AFgIJ
            V0loLYSWTTLEsWLYda15XtFJlY7BWmn1dp1YFqrTa6O20g9vI1YlbKpcFdWdB9uLxcqYXWol
            …
            /aMAAAPcAADAbA==
        </string>
        <key>Regions</key>
        <array>
            <string>custom</string>
            <string>custom2</string>
        </array>
    </dict>
</plist>
}}}