%META:TOPICPARENT{name="VirtWTDStepByStepConfigGuide"}%
---++ WebID+TLS+Delegation VAL ACL Creation
The VAL ACLs to be applied to the Virtuoso server instance allowing SPARQL query access rights to specified named graphs against the Default(HTTP) & SQL Realms, can now be created and loaded into the Virtuoso server. The following sample script file allows SPARQL query access rights via the HTTP & SQL interfaces. See the online documentation for more details on [[http://virtuoso.openlinksw.com/dataspace/doc/dav/wiki/Main/ValQuickStartGuide][VAL ACL configuration]]:
C:\Program Files\OpenLink Software\Virtuso 7.2\database> type loadacl.sql
-- Goal:
-- Restrict access to a specific named graph. In this case you have a named
-- graph IRI derived from each turtle document url in your RDF dump.
-- ACL Rules Declaration Script run via Virtuosos iSQL interface:
-- Make Public Graph Private by adding it to Private Named Graph Group
DB.DBA.RDF_GRAPH_GROUP_INS
('http://www.openlinksw.com/schemas/virtrdf#PrivateGraphs','OpenPermID-bulk-assetClass-20151111_095807.ttl.gz') ;
DB.DBA.RDF_GRAPH_GROUP_INS
('http://www.openlinksw.com/schemas/virtrdf#PrivateGraphs','OpenPermID-bulk-industry-20151111_095806.ttl.gz') ;
-- Conditional Group Description HTTP Realm
-- Cleanup
SPARQL
PREFIX acl:
PREFIX oplacl:
PREFIX foaf:
WITH GRAPH
DELETE
{
<#groupBasicNetID> ?p ?o .
}
WHERE
{
<#groupBasicNetID> ?p ?o .
}
;
-- Conditional Group Definition
SPARQL
PREFIX acl:
PREFIX oplacl:
PREFIX foaf:
WITH GRAPH
INSERT
{
<#groupBasicNetID>
a ;
"Identities Denoted using a NetID based Identifier" ;
[
a ,
;
;
;
1
] .
}
;
-- Clear ACL Cache
VAL.DBA.clear_graph_acl_cache() ;
-- Generic Default Realm (HTTP) Access to SPARQL with Sponger enabled.
-- Cleanup
SPARQL
PREFIX acl:
PREFIX oplacl:
PREFIX foaf:
WITH
DELETE
{
<#NetIDSpongerAccessRule1> ?p ?o .
}
WHERE
{
<#NetIDSpongerAccessRule1> ?p ?o .
}
;
-- ACL Definition
SPARQL
PREFIX acl:
PREFIX oplacl:
PREFIX foaf:
WITH
INSERT
{
<#NetIDSpongerAccessRule1>
a acl:Authorization ;
rdfs:label "Read & Sponger Access Authorization for NetIDs" ;
rdfs:comment """This ACL rule grants Sponger access to any identity denoted by a URI where identity claims
are de-referenced and then verified using a variety of authentication protocols e.g., HTTP Digest, TLS basic,
OAuth, WebID-TLS, OpenID, or Mozilla Persona
""" ;
foaf:maker ;
acl:accessTo ;
oplacl:hasAccessMode oplacl:Read, oplacl:Sponge ;
acl:agent <#groupBasicNetID> ;
oplacl:hasRealm oplacl:DefaultRealm ;
oplacl:hasScope oplacl:Query .
}
;
-- Declare DeaultRealm (HTTP) ACL
-- Cleanup
SPARQL
PREFIX oplacl:
PREFIX acl:
WITH
DELETE
{
<#HttpTLSPrivateNamedGraphRule1> ?p ?o .
}
WHERE
{
<#HttpTLSPrivateNamedGraphRule1> ?p ?o .
}
;
-- ACL Definition
-- Protection of Private Named Graph identified by IRI:
SPARQL
PREFIX oplacl:
PREFIX acl:
WITH
INSERT
{
<#HttpTLSPrivateNamedGraphRule1>
a acl:Authorization ;
rdfs:label "Private Named Graph ACL (HTTP Realm) for Named Graph Identified by IRI: " ;
foaf:maker ;
oplacl:hasAccessMode oplacl:Read ;
acl:accessTo ;
acl:agent <#groupBasicNetID> ;
oplacl:hasScope oplacl:PrivateGraphs ;
oplacl:hasRealm oplacl:DefaultRealm .
}
;
-- Cleanup
SPARQL
PREFIX oplacl:
PREFIX acl:
WITH
DELETE
{
<#HttpTLSPrivateNamedGraphRule2> ?p ?o .
}
WHERE
{
<#HttpTLSPrivateNamedGraphRule2> ?p ?o .
}
;
-- ACL Definition
-- Protection of Private Named Graph identified by IRI:
SPARQL
PREFIX oplacl:
PREFIX acl:
WITH
INSERT
{
<#HttpTLSPrivateNamedGraphRule2>
a acl:Authorization ;
rdfs:label "Private Named Graph ACL (HTTP Realm) for Named Graph Identified by IRI: " ;
foaf:maker ;
oplacl:hasAccessMode oplacl:Read ;
acl:accessTo ;
acl:agent
,
,
,
,
,
,
,
,
,
,
;
oplacl:hasScope oplacl:PrivateGraphs ;
oplacl:hasRealm oplacl:DefaultRealm .
}
;
--- End of Default (HTTP) Realm ACLs for Protected Named Graphs ---
---- Start of SQLRealm ACLs ----
-- Static Group Description
-- Cleanup
SPARQL
PREFIX acl:
PREFIX oplacl:
PREFIX foaf:
WITH GRAPH
DELETE
{
<#SQLTLSstaticGroup> ?p ?o
}
WHERE
{
<#SQLTLSstaticGroup> ?p ?o
}
;
-- Group Definition
SPARQL
PREFIX acl:
PREFIX oplacl:
PREFIX foaf:
WITH GRAPH
INSERT
{
<#SQLTLSstaticGroup>
a foaf:Group ;
foaf:name "Conventional Group" ;
rdfs:comment """Conventioal group used to which a collection of WebIDs (in the form of a list) belong. """ ;
foaf:member
,
,
,
,
,
,
,
,
,
,
.
}
;
-- Conditional Group Description SQL Realm
-- Cleanup
SPARQL
PREFIX acl:
PREFIX oplacl:
PREFIX foaf:
WITH GRAPH
DELETE
{
<#SQLTLSgroupBasicNetID> ?p ?o
}
WHERE
{
<#SQLTLSgroupBasicNetID> ?p ?o
}
;
-- Conditional Group Definition
SPARQL
PREFIX acl:
PREFIX oplacl:
PREFIX foaf:
WITH GRAPH
INSERT
{
<#SQLTLSgroupBasicNetID>
a ;
"Identities Denoted using a NetID based Identifier" ;
[
a ,
;
;
;
1
] .
}
;
-- Grant NetID Group Access to SQL Realm
-- Cleanup
SPARQL
PREFIX oplacl:
PREFIX acl:
PREFIX foaf:
WITH GRAPH
DELETE
{
<#NetIDTLSSQLAccessRule1> ?p ?o .
}
WHERE
{
<#NetIDTLSSQLAccessRule1> ?p ?o .
}
;
-- ACL Definition
SPARQL
PREFIX oplacl:
PREFIX acl:
PREFIX foaf:
WITH GRAPH
INSERT
{
<#NetIDTLSSQLAccessRule1> a acl:Authorization ;
foaf:maker ;
rdfs:label "SQL Realm Access Authorization ACL for NetIDs" ;
rdfs:comment """Conditional Group based ACL that provides NetIDs with SQL Realm Access.""" ;
oplacl:hasAccessMode oplacl:Read ;
acl:accessTo ;
acl:agent <#groupBasicNetID>, <#staticGroup> ;
oplacl:hasScope oplacl:Query ;
oplacl:hasRealm oplacl:SqlRealm .
}
;
-- SPASQL Access Privileges Grant to a Specific WebID (this is required for LOD Connectivity Licenses )--
-- Cleanup
SPARQL
PREFIX oplacl:
PREFIX acl:
PREFIX foaf:
WITH GRAPH
DELETE
{
<#WebIDTLSPASQLAccessRule1> ?p ?o.
}
WHERE
{
<#WebIDTLSPASQLAccessRule1> ?p ?o.
}
;
-- ACL Description
SPARQL
PREFIX oplacl:
PREFIX acl:
PREFIX foaf:
WITH GRAPH
INSERT
{
<#WebIDTLSPASQLAccessRule1> a acl:Authorization ;
foaf:maker ;
rdfs:label "SQL Realm Access Authorization ACL" ;
rdfs:comment """Mandatory ACL for granting access to SQL Realm which then enables ODBC, JDBC, ADO.NET, OLE-DB compliant
application access, subject to Agent & User Identity.""" ;
oplacl:hasAccessMode oplacl:Read ;
acl:accessTo ;
acl:agent
,
,
,
,
,
,
,
,
,
,
;
oplacl:hasScope oplacl:Query ;
oplacl:hasRealm oplacl:SqlRealm .
}
;
-- SQL Realm Authorizations (enables execution of SQL queries via SQL+TLS connections)
-- Cleanup
SPARQL
PREFIX oplacl:
PREFIX acl:
PREFIX foaf:
WITH GRAPH
DELETE
{
<#WebIDTLSSQLAccessRule1> ?p ?o.
}
WHERE
{
<#WebIDTLSSQLAccessRule1> ?p ?o.
}
;
-- ACL Description
SPARQL
PREFIX oplacl:
PREFIX acl:
PREFIX foaf:
WITH GRAPH
INSERT
{
<#WebIDTLSSQLAccessRule1> a acl:Authorization ;
foaf:maker ;
rdfs:label "SQL Realm Access Authorization ACL" ;
rdfs:comment """Mandatory ACL for granting access to SQL Realm which then enables ODBC, JDBC, ADO.NET, OLE-DB compliant
application access, subject to Agent & User Identity.""" ;
oplacl:hasAccessMode oplacl:Read ;
acl:accessTo ;
acl:agent
,
,
,
,
,
,
,
,
,
,
;
oplacl:hasScope oplacl:Query ;
oplacl:hasRealm oplacl:SqlRealm .
}
;
--- SQL Query Access Restrictions (SQLRealm re. ODBC, JDBC, ADO.NET) ---
-- Query Request Rate
-- Cleanup
SPARQL
PREFIX oplacl:
PREFIX acl:
PREFIX foaf:
PREFIX oplrest:
WITH GRAPH
DELETE
{
<#URIBurnerTLSSQLAccessRestriction1> ?p ?o .
}
WHERE
{
<#URIBurnerTLSSQLAccessRestriction1> ?p ?o .
}
;
-- Restriction Definition
SPARQL
PREFIX oplacl:
PREFIX acl:
PREFIX foaf:
PREFIX oplrest:
WITH GRAPH
INSERT
{
<#URIBurnerTLSSQLAccessRestriction1>
a oplrest:Restriction ;
foaf:maker ;
rdfs:label "SQL Realm Query Rate Restriction" ;
rdfs:comment """Mandatory Restriction for metering Query Request Rates per second.""" ;
oplacl:hasAccessMode oplacl:Read ;
oplrest:hasRestrictedResource ;
oplrest:hasMaxValue "100"^^xsd:integer ;
acl:agent
,
,
,
,
,
,
,
,
,
,
;
oplacl:hasRealm oplacl:SqlRealm .
}
;
-- Query Results Size
-- Cleanup
SPARQL
PREFIX oplacl:
PREFIX acl:
PREFIX foaf:
PREFIX oplrest:
WITH GRAPH
DELETE
{
<#URIBurnerTLSSQLAccessRestriction2> ?p ?o .
}
WHERE
{
<#URIBurnerTLSSQLAccessRestriction2> ?p ?o .
}
;
-- Restriction Definition
SPARQL
PREFIX oplacl:
PREFIX acl:
PREFIX foaf:
PREFIX oplrest:
WITH GRAPH
INSERT
{
<#URIBurnerTLSSQLAccessRestriction2>
a oplrest:Restriction ;
foaf:maker ;
rdfs:label "SQL Realm Resultset [Query Solution] Size Restriction" ;
rdfs:comment """Mandatory Restriction for restrictng maximum size of query resultsets [solutions].""" ;
oplrest:hasRestrictedResource ;
oplrest:hasMaxValue "200"^^xsd:integer ;
acl:agent
,
,
,
,
,
,
,
,
,
,
;
oplacl:hasRealm oplacl:SqlRealm .
}
;
-- Private Graph ACL Private Named Graph identified by IRI:
-- Cleanup
SPARQL
PREFIX oplacl:
PREFIX acl:
WITH
DELETE
{
<#TLSSQLPrivateNamedGraphRule1> ?p ?o .
}
WHERE
{
<#TLSSQLPrivateNamedGraphRule1> ?p ?o .
}
;
-- ACL Description
SPARQL
PREFIX oplacl:
PREFIX acl:
WITH
INSERT
{
<#TLSSQLPrivateNamedGraphRule1>
a acl:Authorization ;
rdfs:label "Private Named Graph ACL (SQL Realm) for Named Graph Identified by IRI: " ;
foaf:maker ;
oplacl:hasAccessMode oplacl:Read ;
acl:accessTo ;
acl:agent <#SQLTLSgroupBasicNetID>, <#SQLTLSstaticGroup> ;
oplacl:hasScope oplacl:PrivateGraphs ;
oplacl:hasRealm oplacl:SqlRealm .
}
;
-- Private Graph ACL Private Named Graph identified by IRI:
-- Cleanup
SPARQL
PREFIX oplacl:
PREFIX acl:
WITH
DELETE
{
<#TLSSQLPrivateNamedGraphRule2> ?p ?o .
}
WHERE
{
<#TLSSQLPrivateNamedGraphRule2> ?p ?o .
}
;
-- ACL Description
SPARQL
PREFIX oplacl:
PREFIX acl:
WITH
INSERT
{
<#TLSSQLPrivateNamedGraphRule2>
a acl:Authorization ;
rdfs:label "Private Named Graph ACL (SQL Realm) for Named Graph Identified by IRI: " ;
foaf:maker ;
oplacl:hasAccessMode oplacl:Read ;
acl:accessTo ;
acl:agent
,
,
,
,
,
,
,
,
,
,
;
oplacl:hasScope oplacl:PrivateGraphs ;
oplacl:hasRealm oplacl:SqlRealm .
}
;
-- Add sample data
SPARQL
WITH
INSERT { <#this> <#relatedTo> <#that> } ;
SPARQL
WITH
INSERT {<#kingsley> <#knows> <#hugh> } ;
COMMIT WORK ;
A normal digest connection can then be made to the Virtuoso database using isql command line tool and the script loaded into Virtuoso as follows:
C:\Program Files\OpenLink Software\Virtuso 7.2\database> ..\bin\isql 1111
Connected to OpenLink Virtuoso
Driver: 07.20.3217 OpenLink Virtuoso ODBC Driver
OpenLink Interactive SQL (Virtuoso), version 07.20.3217.
Type HELP; for help and EXIT; to exit.
SQL> load loadacl.sql;
Done. -- 4 msec.
Done. -- 0 msec.
Done. -- 4 msec.
Done. -- 8 msec.
Done. -- 1 msec.
Done. -- 43 msec.
Done. -- 3 msec.
Done. -- 2 msec.
Done. -- 2 msec.
Done. -- 2 msec.
Done. -- 3 msec.
Done. -- 2 msec.
Done. -- 2 msec.
Done. -- 2 msec.
Done. -- 5 msec.
Done. -- 2 msec.
Done. -- 3 msec.
Done. -- 2 msec.
Done. -- 3 msec.
Done. -- 2 msec.
Done. -- 3 msec.
Done. -- 1 msec.
Done. -- 4 msec.
Done. -- 1 msec.
Done. -- 4 msec.
Done. -- 1 msec.
Done. -- 2 msec.
Done. -- 2 msec.
Done. -- 3 msec.
Done. -- 0 msec.
SQL>