File

teal-src/util/dataforms.d.tl @ 12659:c0eea4f6c739

usermanager: Add back temporary is_admin to warn about deprecated API usage Goal: Introduce role-auth with minimal disruption is_admin() is unsafe in a system with per-session permissions, so it has been deprecated. Roll-out approach: 1) First, log a warning when is_admin() is used. It should continue to function normally, backed by the new role API. Nothing is really using per-session authz yet, so there is minimal security concern. The 'strict_deprecate_is_admin' global setting can be set to 'true' to force a hard failure of is_admin() attempts (it will log an error and always return false). 2) In some time (at least 1 week), but possibly longer depending on the number of affected deployments: switch 'strict_deprecate_is_admin' to 'true' by default. It can still be disabled for systems that need it. 3) Further in the future, before the next release, the option will be removed and is_admin() will be permanently disabled.
author Matthew Wild <mwild1@gmail.com>
date Mon, 15 Aug 2022 15:25:07 +0100
parent 12615:b2047b82ec85
line wrap: on
line source

local stanza_t = require "util.stanza".stanza_t

local record lib
	record dataform
		title : string
		instructions : string

		record form_field

			enum field_type
				"boolean"
				"fixed"
				"hidden"
				"jid-multi"
				"jid-single"
				"list-multi"
				"list-single"
				"text-multi"
				"text-private"
				"text-single"
			end

			type : field_type
			var : string -- protocol name
			name :  string -- internal name

			label : string
			desc : string

			datatype : string
			range_min : number
			range_max : number

			value : any -- depends on field_type
			options : table
		end

		{ form_field }

		enum form_type
			"form"
			"submit"
			"cancel"
			"result"
		end

		form : function ( dataform, { string : any }, form_type ) : stanza_t
		data : function ( dataform, stanza_t ) : { string : any }
	end

	new : function ( dataform ) : dataform
end

return lib