[Bug 32125] Should support auth using captcha

[bugzilla-daemon at freedesktop.org]

https://bugs.freedesktop.org/show_bug.cgi?id=32125

--- Comment #3 from Simon McVittie <simon.mcvittie at collabora.co.uk> 2012-01-25 09:34:41 PST ---
Sketch of an interface modelling XEP-0158 for this: as above, except:

GetCaptchas() -> a(u: ID, s: Type, s: Label, u: Flags),
                 u: Number_Required,
                 s: Language

    ID is unique within this channel instance only.

    One flag defined: Required. Most captchas will have no flags.

    Type is as defined in XEP-0158.

    Label is as defined in XEP-0158. In particular, for "qa" it's the
    question.

    Language is the language of each Label as an RFC 5646 language tag,
    e.g. "en_US", or "" if unknown.

GetCaptchaData(u: ID, as: Mime_Types) -> ay

    Fetch and return the captcha data, giving highest priority to MIME
    types earlier in the list if possible. The CM is expected to implement
    HTTP, for instance, if captchas in this protocol generally require it.

    Returns an empty array if the type was "qa".

    [Rationale: If audio-based and image-based captchas are both available,
    we don't want to waste time downloading the audio until/unless the
    user asks to hear it. The extra D-Bus round-trips are not a problem,
    since they are expected to be quick compared with the time taken for
    the user to solve the captcha.]

AnswerCaptchas(a{u: ID => s: Answer}) -> nothing

    (As in the single-captcha case, but answer many captchas simultaneously.)

-- 
Configure bugmail: https://bugs.freedesktop.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA Contact for the bug.
You are the assignee for the bug.