From 27ae9095639bb228a1b7ff86a3ebe4264abf05be Mon Sep 17 00:00:00 2001 From: mschaefers <mschaefers@scoop-gmbh.de> Date: Thu, 29 Nov 2012 12:33:09 -0500 Subject: [PATCH] feature: when using LdapUserService one can configure Gitblit to fetch all users from ldap that can possibly login. This allows to see newly generated LDAP users instantly in Gitblit. By now an LDAP user had to log in once to appear in GitBlit. --- 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