Search the Secrets API; spec is like `auth-source'.
The :label key specifies the item's label. It is the only key
that can specify a substring. Any :label value besides a string
will allow any label.
All other search keys must match exactly. If you need substring
matching, do a wider search and narrow it down yourself.
You'll get back all the properties of the token as a plist.
Here's an example that looks for the first item in the 'Login'
Secrets collection:
(let ((auth-sources '("secrets:Login")))
(auth-source-search :max 1)
Here's another that looks for the first item in the 'Login'
Secrets collection whose label contains 'gnus':
(let ((auth-sources '("secrets:Login")))
(auth-source-search :max 1 :label "gnus")
And this one looks for the first item in the 'Login' Secrets
collection that's a Google Chrome entry for the git.gnus.org site
authentication tokens:
(let ((auth-sources '("secrets:Login")))
(auth-source-search :max 1 :signon_realm "https://git.gnus.org/Git"))
(fn &rest SPEC &key BACKEND CREATE DELETE LABEL TYPE MAX HOST USER PORT &allow-other-keys)