This handbook is written for LinkedData.Center Enterprise service managers. The users of LinkedData.Center services do not need to bother with this kind of topics. LinkedData.Center ontologyTo describe our things, we use a pretty common jargon that, more or less, is consistent with ITIL glossary. This chapter wants to give you a semantic context for main terms (in bold) used in LinkedData.Center service management processes. When available, a link to a formal ontology is also provided. LinkedData.Center is a service provider that provides IT digital services designed for a multitenancy system architecture. A service subscription is a Service Level Agreement (SLA) with a defined duration (e.g. lifetime or monthly) and a subscription state:
The service manager is a role responsible for the provisioning of all the resources needed to activate the subscriptions. It is also responsible for the service operation and for the service retirement processes. Subscribers can contact the service manager using the LinkedData.Center support center that acts as service desk and as a single point of contact. Beside the service plans, LinkedData.Center offers LinkedData.Center Enterprisetm. This offering is about the whole or part LinkedData.Center Enterpriseservice Platform (LDCEP). licensed, installed and maintained at customer premises. LDCEP requires a custom SLA where authorized service managers are appointed. The main feature of LDCEP is to provide RDF Graph Database Instances that are managed through Elastic Knowledge Base APIs (EKB APIs). When a customer subscribes a plan that includes a graph database instance, the following resources are needed:
Please note that the concept of user has nothing to do with account . A user is a resource owned by the service provider and leased to the subscriber for all the subscription duration. It can be used by a software agent or by people under the sole responsibility of the subscriber. Service Manager can reset the user password on explicit subscriber request. On the other side, an account is owned by the subscriber and it is self managed through the features of LinkedData.Center subscription portal. The service manager allocates required profile and user resources to all pending activation subscriptions, generating them manually or automatically. The service manager communicates user credentials (i.e. username and password) and service endpoint URL to the subscriber before to change the service status to active. At the end of the subscription agreement, the service manager disposes the subscription resources cleaning user and profile data and all other related resources (.e. graph DB instance, backups, etc, etc). Resource managementLinkedData.Center describes and manages core resources accordingly to the RESTful architecture. Specifically, every core resource is described by an hypermedia schema (JSON-Schema) and managed by REST profiler APIs. There are three core resource types: All the resources are completely indipendent. The Service Manager maintains the links between subscriptions, accounts, users and profiles in the administration panel . Every service manager owns a credential that grants access to the profiler endpoint. The service Manager is free to use his/her preferred tool (any RESTful client is compliant) or to use the Jsonary.LinkedData.Center service that allows to application to browse the resources. Profiler sandboxPractice with the profiler APIs connecting to the profiler sandbox endpoint using the shared credential admin/password. Please note that data are stored in clear and the sandbox server is shared and public. DO NOT STORE REAL OR PRIVATE DATA IN THE JSONARY SANDBOX!! Using jsonaryJsonary is a simple interactive web tool used to manipulate RESTful resources. Linked data jsonary implementation is available at http://jsonary.linkeddata.center/. Think to jsonary as a browser in a browser. Put your profiler endpoint URL in the resource bar, add to it the resource you need to view/edit/delete and click the go button. At the beginning of the session, you will be asked for your credential. Close the browser to log off. All network traffic is encrypted with SSL. Jsonary is able to manage your resource even if they are not exposed to the internet. To use jsonary with profiler sandbox just point your browser to http://jsonary.linkeddata.center/?url=http%3A//profiler.sandbox.linkeddata.center/ URL. Profile resourcesTo create a new profile type your profile listing ( https://your.profiler.endpoint/profile/) in the URL bar and click on the go button.Then press "new profile" button to display the popup: Fill the form completing all wanted data. If not provided, the system will use proper defaults. Of course, you have also to configure the graph engine to setup a proper user space (this step depends on the RDF technology you decided to adopt). User resourcesTo create a new profile type your profile listing ( https://your.profiler.endpoint/user/) in the URL bar and click on the go button. Then press "New user" button to display the popup: The password field is a bit tricky. For security reasons, the password will never be stored in plain text. You can choose the encoding algorithm, but the most secure is the CRYPT_BLOWFISH algorithm. We suggest to use one of the good online generators or write your own according to the PHP password_hash specification. You can provide unencoded passwords to your customers while storing the encoded ones in the user resource. Administrative tasks free service managers to manually create users, profiles, and graph engine configurations. The service manager creates administrative tasks using the profiler APIs and then a provision orchestrator will launch the proper task processor to consume the task allocating all required resources. Task processors are custom developed for LDCEP. Tasks required few mandatory fields:
Beside this, other data depending on the task type could be required. Following task types are defined:
|