summaryrefslogtreecommitdiffabout
path: root/include/opkele/sreg.h
blob: df37a866eaf99ee6daba350542e1169b3b28909e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
#ifndef __OPKELE_SREG_H
#define __OPKELE_SREG_H

/**
 * @file
 * @brief Simple registration extension
 */

#include <opkele/extension.h>

namespace opkele {
    using std::map;

    /**
     * OpenID simple registration extension implementation
     * http://openid.net/specs/openid-simple-registration-extension-1_0.html
     */
    class sreg_t : public extension_t {
	public:
	    /**
	     * sreg fields enumeration
	     */
	    enum fieldbit_t {
		/**
		 * Any UTF-8 string that the End User wants to use as a nickname.
		 */
		field_nickname = 1,
		/**
		 * The email address of the End User as specified in section 3.4.1 of [RFC2822]
		 */
		field_email = 2,
		/**
		 * UTF-8 string free text representation of the End User's full name.
		 */
		field_fullname = 4,
		/**
		 * The End User's date of birth as YYYY-MM-DD. Any values whose
		 * representation uses fewer than the specified number of
		 * digits should be zero-padded. The length of this value MUST
		 * always be 10. If the End User user does not want to reveal
		 * any particular component of this value, it MUST be set to
		 * zero.
		 *
		 * For instance, if a End User wants to specify that his date
		 * of birth is in 1980, but not the month or day, the value
		 * returned SHALL be "1980-00-00".
		 */
		field_dob = 8,
		/**
		 * Alias to field_dob
		 */
		field_birthdate = field_dob,
		/**
		 * The End User's gender, "M" for male, "F" for female.
		 */
		field_gender = 16,
		/**
		 * Alias to field_gender
		 */
		field_sex = field_gender,
		/**
		 * UTF-8 string free text that SHOULD conform to the End User's
		 * country's postal system.
		 */
		field_postcode = 32,
		/**
		 * The End User's country of residence as specified by ISO3166
		 */
		field_country = 64,
		/**
		 * End User's preferred language as specified by ISO639
		 */
		field_language = 128,
		/**
		 * ASCII string from TimeZone database
		 *
		 * For example, "Europe/Paris" or "America/Los_Angeles". 
		 */
		field_timezone = 256,
		/**
		 * All fields bits combined
		 */
		fields_ALL = 511,
		/**
		 * No fields
		 */
		fields_NONE = 0
	    };
	    /**
	     * Bitmask for fields which, if absent from the response, will
	     * prevent the Consumer from completing the registration without
	     * End User interation.
	     */
	    long fields_required;
	    /**
	     * Bitmask for fields that will be used by the Consumer, but whose
	     * absence will not prevent the registration from completing.
	     */
	    long fields_optional;
	    /**
	     * A URL which the Consumer provides to give the End User a place
	     * to read about the how the profile data will be used. The
	     * Identity Provider SHOULD display this URL to the End User if it
	     * is given. 
	     */
	    string policy_url;

	    /**
	     * Bitmask for fields present in response
	     */
	    long has_fields;
	    /**
	     * Container type for response fields values
	     */
	    typedef map<fieldbit_t,string> response_t;
	    /**
	     * Response contents
	     */
	    response_t response;

	    /**
	     * Fields bitmask to send in response
	     */
	    long fields_response;

	    /**
	     * Consumer constructor.
	     * @param fr required fields
	     * @see fields_required
	     * @param fo optional fields
	     * @see fields_optional
	     * @param pu policy url
	     * @see policy_url
	     */
	    sreg_t(long fr=fields_NONE,long fo=fields_NONE,const string& pu="")
		: fields_required(fr), fields_optional(fo), policy_url(pu), has_fields(0) { }

	    /**
	     * Implementation of consumer's checkid hook
	     */
	    virtual void checkid_hook(params_t& p,const string& identity);
	    /**
	     * Implementation of consumer's id_res hook
	     */
	    virtual void id_res_hook(const params_t& p,const params_t& sp,const string& identity);
	    /**
	     * Implementation of server's checkid_hook
	     */
	    virtual void checkid_hook(const params_t& pin,params_t& pout);

	    /**
	     * Check and see if we have value for some particular field.
	     * @param fb field in question
	     * @see fieldbit_t
	     * @return true if the value is available
	     */
	    bool has_field(fieldbit_t fb) const { return has_fields&fb; }

	    /**
	     * Retrieve the value for a field.
	     * @param fb field in question
	     * @see fieldbit_t
	     * @return field value
	     * @throw failed_lookup if no data avaialble
	     */
	    const string& get_field(fieldbit_t fb) const;

	    /**
	     * Set the value for a field.
	     * @param fb field in question
	     * @see fieldbit_t
	     * @param fv field value
	     */
	    void set_field(fieldbit_t fb,const string& fv);

	    /**
	     * Remove the value for a field.
	     * @param fb field in question
	     * @see fieldbit_t
	     */
	    void reset_field(fieldbit_t fb);

	    /**
	     * Reset field data
	     */
	    void clear();

	    /**
	     * Function called after parsing sreg request to set up response
	     * fields. The default implementation tries to send as much fields
	     * as we have. The function is supposed to set the data and
	     * fields_response.
	     * @see fields_response
	     * @param pin input request parameters with "openid." prefix
	     * @param pout output request parameters without "openid." prefix.
	     * @see checkid_hook(const params_t&,params_t&)
	     */
	    virtual void setup_response(const params_t& pin,params_t& pout);

    };
}

#endif /* __OPKELE_SREG_H */