From e5aaa5db9b323f58d9eb8338532fd04fce885048 Mon Sep 17 00:00:00 2001 From: James Moger <james.moger@gitblit.com> Date: Mon, 22 Oct 2012 16:22:37 -0400 Subject: [PATCH] Permission regexes are now case-insensitive --- docs/02_rpc.mkd | 27 +++++++++++++++++++++------ 1 files changed, 21 insertions(+), 6 deletions(-) diff --git a/docs/02_rpc.mkd b/docs/02_rpc.mkd index 5cd0052..35528bf 100644 --- a/docs/02_rpc.mkd +++ b/docs/02_rpc.mkd @@ -37,7 +37,7 @@ The Gitblit API includes methods for retrieving and interpreting RSS feeds. The Gitblit Manager uses these methods to allow branch activity monitoring and repository searching. -<table> +<table class="table"> <tr><th>url parameter</th><th>default</th><th>description</th></tr> <tr><td colspan='3'><b>standard query</b></td></tr> <tr><td><em>repository</em></td><td><em>required</em></td><td>repository name is part of the url (see examples below)</td></tr> @@ -58,16 +58,26 @@ ## JSON Remote Procedure Call (RPC) Interface ### RPC Protocol Versions -<table> +<table class="table"> <tbody> <tr><th>Release</th><th>Protocol Version</th></tr> <tr><td>Gitblit v0.7.0</td><td>1 (inferred version)</td></tr> <tr><td>Gitblit v0.8.0</td><td>2</td></tr> +<tr><td>Gitblit v0.9.0 - v1.0.0</td><td>3</td></tr> +<tr><td>Gitblit v1.1.0</td><td>4</td></tr> +<tr><td>Gitblit v1.2.0+</td><td>5</td></tr> </tbody> </table> +#### Protocol Version 5 + +- *SET_REPOSITORY_MEMBERS* will reject all calls because this would elevate all discrete permissions to RW+ +Use *SET_REPOSITORY_MEMBER_PERMISSIONS* instead. +- *SET_REPOSITORY_TEAMS* will reject all calls because this would elevate all discrete permissions to RW+ +Use *SET_REPOSITORY_TEAM_PERMISSIONS* instead. + ### RPC Request and Response Types -<table> +<table class="table"> <tr><th colspan='2'>url parameters</th><th rowspan='2'>required<br/>user<br/>permission</th><th rowspan='2'>protocol<br/>version</th><th colspan='2'>json</th></tr> <tr><th>req=</th><th>name=</th><th>post body</th><th>response body</th></tr> <tr><td colspan='6'><em>web.enableRpcServlet=true</em></td></tr> @@ -88,10 +98,15 @@ <tr><td>EDIT_TEAM</td><td>team name</td><td><em>admin</em></td><td>2</td><td>TeamModel</td><td>-</td></tr> <tr><td>DELETE_TEAM</td><td>team name</td><td><em>admin</em></td><td>2</td><td>-</td><td>-</td></tr> <tr><td>LIST_REPOSITORY_MEMBERS</td><td>repository name</td><td><em>admin</em></td><td>1</td><td>-</td><td>List<String></td></tr> -<tr><td>SET_REPOSITORY_MEMBERS</td><td>repository name</td><td><em>admin</em></td><td>1</td><td>List<String></td><td>-</td></tr> +<tr><td><s>SET_REPOSITORY_MEMBERS</s></td><td><s>repository name</s></td><td><em><s>admin</s></em></td><td><s>1</s></td><td><s>List<String></s></td><td>-</td></tr> +<tr><td>LIST_REPOSITORY_MEMBER_PERMISSIONS</td><td>repository name</td><td><em>admin</em></td><td>5</td><td>-</td><td>List<String></td></tr> +<tr><td>SET_REPOSITORY_MEMBER_PERMISSIONS</td><td>repository name</td><td><em>admin</em></td><td>5</td><td>List<String></td><td>-</td></tr> <tr><td>LIST_REPOSITORY_TEAMS</td><td>repository name</td><td><em>admin</em></td><td>2</td><td>-</td><td>List<String></td></tr> -<tr><td>SET_REPOSITORY_TEAMS</td><td>repository name</td><td><em>admin</em></td><td>2</td><td>List<String></td><td>-</td></tr> +<tr><td><s>SET_REPOSITORY_TEAMS</s></td><td><s>repository name</s></td><td><em><s>admin</s></em></td><td><s>2</s></td><td><s>List<String></s></td><td>-</td></tr> +<tr><td>LIST_REPOSITORY_TEAM_PERMISSIONS</td><td>repository name</td><td><em>admin</em></td><td>5</td><td>-</td><td>List<String></td></tr> +<tr><td>SET_REPOSITORY_TEAM_PERMISSIONS</td><td>repository name</td><td><em>admin</em></td><td>5</td><td>List<String></td><td>-</td></tr> <tr><td>LIST_SETTINGS</td><td>-</td><td><em>admin</em></td><td>1</td><td>-</td><td>ServerSettings (management keys)</td></tr> +<tr><td>CLEAR_REPOSITORY_CACHE</td><td>-</td><td><em>-</em></td><td>4</td><td>-</td><td>-</td></tr> <tr><td colspan='6'><em>web.enableRpcAdministration=true</em></td></tr> <tr><td>LIST_FEDERATION_REGISTRATIONS</td><td>-</td><td><em>admin</em></td><td>1</td><td>-</td><td>List<FederationModel></td></tr> <tr><td>LIST_FEDERATION_RESULTS</td><td>-</td><td><em>admin</em></td><td>1</td><td>-</td><td>List<FederationModel></td></tr> @@ -103,7 +118,7 @@ </table> ### RPC/HTTP Response Codes -<table> +<table class="table"> <tr><th>code</th><th>name</th><th>description</th></tr> <tr><td>200</td><td>success</td><td>Gitblit processed the request successfully</td></tr> <tr><td>401</td><td>unauthorized</td><td>Gitblit requires user credentials to process the request</td></tr> -- Gitblit v1.9.1