OSID - osid.authentication.keys.Key Service Interface Definition

Interface	osid.authentication.keys.Key
Implements	`osid.OsidObject`
Used By	`osid.authentication.keys.KeyAdminSession`
	`osid.authentication.keys.KeyList`
	`osid.authentication.keys.KeyLookupSession`
Description	The key represents cryptographic data managed by the authentication service. An `Agent` maps to a `Key` and there is only one `Key` per `Agent`.
Method	getAgentId
Description	Gets the `AgentId` corresponding to this key.
Return	`osid.id.Id`		the agent `Id`
Compliance	`mandatory`		This method must be implemented.
Method	getAgent
Description	Gets the `Agent` corresponding to this key.
Return	`osid.authentication.Agent`		the agent
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getKeyRecord
Description	Gets the key record corresponding to the given `Key` record `Type`.This method is used to retrieve an object implementing the requested record. The `keyRecordType` may be the `Type` returned in `getRecordTypes()` or any of its parents in a `Type` hierarchy where `hasRecordType(keyRecordType)` is `true`.
Parameters	`osid.type.Type`	`keyRecordType`	a key record type
Return	`osid.authentication.keys.records.KeyRecord`		the key record
Errors	NULL_ARGUMENT		`keyRecordType` is `null`
	OPERATION_FAILED		unable to complete request
	UNSUPPORTED		`hasRecordType(keyRecordType)` is `false`
Compliance	`mandatory`		This method must be implemented.