<?xml version="1.0" encoding="UTF-8" ?>

<node name="/" xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">

    <interface name="org.freedesktop.NetworkManager.Settings.Connection.Secrets">
        <tp:docstring>
            Secrets have a separate interface so that they can be locked down.
        </tp:docstring>

        <method name="GetSecrets">
            <tp:docstring>
                Get the secrets encapsulated in this object.
            </tp:docstring>
            <annotation name="org.freedesktop.DBus.GLib.CSymbol" value="impl_exported_connection_get_secrets"/>
            <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>
            <arg name="setting_name" type="s" direction="in">
                <tp:docstring>
                    Name of the setting to return.
                </tp:docstring>
            </arg>
            <arg name="hints" type="as" direction="in">
                <tp:docstring>
                    Array of strings of key names in the Setting for which NM thinks
                    a secrets may be required.
                </tp:docstring>
            </arg>
            <arg name="request_new" type="b" direction="in">
                <tp:docstring>
                    Indicates whether new secrets should be requested or if the request can be fulfilled from storage.
                </tp:docstring>
            </arg>

            <arg name="secrets" type="a{sa{sv}}" direction="out" tp:type="String_String_Variant_Map_Map">
                <annotation name="com.trolltech.QtDBus.QtTypeName.Out0" value="QVariantMapMap"/>
                <tp:docstring>
                    Nested settings maps containing secrets.  Each setting MUST contain at least the 'name' field, containing the name of the setting, and one or more secrets.
                </tp:docstring>
            </arg>
        </method>

    </interface>

</node>
