Add new attachment

Only authorized users are allowed to upload new attachments.

List of attachments

Kind Attachment Name Size Version Date Modified Author Change note
xml
permissions.xml 0.2 kB 1 09-Oct-2016 18:14 Ben Spink
xml
user.xml 0.2 kB 1 09-Oct-2016 18:14 Ben Spink
xml
vfs_items.xml 0.3 kB 1 09-Oct-2016 18:14 Ben Spink

This page (revision-27) was last changed on 10-Sep-2018 13:01 by Ada Csaba

This page was created on 09-Oct-2016 18:14 by Ben Spink

Only authorized users are allowed to rename pages.

Only authorized users are allowed to delete pages.

Difference between version and

At line 1 changed one line
If you are reading this, you are likely wanting a well documented published API to reference. You won't find that here. Its my opinion that the admin WebInterface provides a working example that is easily watched to see the commands its issuing for the documentation. If you want to know how to make a user using a web call, enable the network monitoring in Chrome/Safari/FireBug and make a user. Then its all detailed out.
(File Transfer API can be found here: [APIFileTransfer].)
!!!Admin API Tool: (as of CrushFTP v8.1)\\
First launch the command line tool passing it the arguments as an admin username and password (CrushTunnel.jar is located in your WebInterface folder):\\
{{{
java -jar CrushTunnel.jar https://crushamdin:password@yourserver.com/
}}}
Now you can issue the user command to add a user, assign a VFS.\\
{{{
user user_add MainUsers user3 password=password
user vfs_add MainUsers user3 path=/home/ privs=(read)(write)(resume)(delete)(view) url=file://home/ name=home
user vfs_delete MainUsers user3 path=/home/ name=home
}}}
Where:
At line 3 changed one line
I will provide one example here to get you started though, and I may add to this by user request if things are not clear enough.
"path" is the FTP style path to the folder, relative to the user's virtual root, "/".
At line 17 added 42 lines
"privs" the user VFS folder permissions, can be any combination of (read)(write)(view)(delete)(deletedir)(makedir)(rename)(resume)(share)(slideshow)(invisible)(ratio)
(replicate)(locked) , for details see our user VFS related docs page.
"url" the true URL pointing to the folder itself.
You can also assign groups, and inheritance:\\
{{{
user group_add MainUsers user3 groupname
user inheritance_add MainUsers user3 groupname
}}}
Or remove a user from a group or inheritance:\\
{{{
user group_delete MainUsers user3 groupname
user inheritance_delete MainUsers user3 groupname
}}}
You can use the user API call in CrushTunnel.jar to set the field: allowed_protocols to configure Port restrictions
{{{
ftp:0,ftps:0,sftp:0,http:0,https:0,webdav:0,
}}}
That is the default, but if you only wanted to allow sftp and https, you could do:
sftp:0,https:0,
Its also possible to tell the server to run a Job if you want to remote control jobs:\\
{{{
job remote MyFindJob
}}}
\\
\\
\\
!!!Alternative methods using raw CURL commands:\\
If you are reading this, you are likely wanting a well documented published API to reference. You won't find that here. Its our opinion that the admin WebInterface provides a working example that is easily watched to see the commands its issuing for the documentation. If you want to know how to make a user using a web call, enable the network monitoring in Chrome/Safari/FireFox/Edge and make a user. Then its all detailed out in the network requests created.
Here are a few examples here to get you started though, and we may add to this list in the future too.
''(The attachments tab at the top contains the sample files.)''\\
\\
\\
At line 6 changed one line
Making a new User for the User Manager
!Registering CrushFTP service from command line.
At line 9 changed one line
Builds a brand new user, or replaces and existing one entirely.
Uses a command to register the CrushFTP license key in case you need to deploy on multiple machines E3 specific, and need to automate the registration.
The spaces and special characters need to be URL encoded
At line 67 added 11 lines
curl -d command=registerCrushFTP -d registration_name=MY%2520NAME -d registration_email=MYNAME%2540MYEMAIL.COM.EXAMPLE -d registration_code=my_reg_code -u crushadmin:'password' http://127.0.0.1:8080/
}}}
''(long line, so get it all)''
\\
----
!Making a new User with VFS
----
Builds a brand new user, or replaces an existing one entirely.
{{{
At line 14 changed one line
(long line, so get it all)
''(long line, so get it all)''
At line 17 changed one line
Updating a user in the User Manager
!Updating a user
At line 25 changed one line
(long line, so get it all)
''(long line, so get it all)''
\\
\\
!Update/add to VFS of a user\\
This will update the VFS, either replacing an existing item, or adding a new item if it doesn't exist:\\
{{{
curl -d command=setUserItem -d data_action=update_vfs -d xmlItem=user -d serverGroup=MainUsers -d username=user1 -d vfs_items@vfs_items.XML -d permissions@permissions.XML -u crushadmin:passw http://127.0.0.1:8080/
}}}
''(long line, so get it all)''
\\
!Delete VFS item from a user\\
This will remove a VFS item (so don't pass in a full permissions or vfs_items object or you would remove everything):\\
{{{
curl -d command=setUserItem -d data_action=update_vfs_remove -d xmlItem=user -d serverGroup=MainUsers -d username= user1 -d vfs_items@vfs_items.XML -d permissions@VFS.XML -u crushadmin:pass http://127.0.0.1:8080/
}}}
''(long line, so get it all)''
\\
\\
!!Groups and Inheritance:\\
\\
Add some users into a group, it will make the group if it doesn't exist:\\
{{{
curl -d command=setUserItem -d xmlItem=groups -d serverGroup=MainUsers -d data_action=add -d group_name=MyGroup -d usernames="user1;user2" -u crushadmin:pass http://127.0.0.1:8080/
}}}
''(long line, so get it all)''\\
\\
Delete users from a group:\\
{{{
curl -d command=setUserItem -d xmlItem=groups -d serverGroup=MainUsers -d data_action=delete -d group_name=MyGroup -d usernames="user1;user2" -u crushadmin:pass http://127.0.0.1:8080/
}}}
''(long line, so get it all)''\\
\\
Delete an entire group:\\
{{{
curl -d command=setUserItem -d xmlItem=groups -d serverGroup=MainUsers -d data_action=delete -d group_name=MyGroup -u crushadmin:pass http://127.0.0.1:8080/
}}}
''(long line, so get it all)''\\
\\
Add some users to inheritance, it will make the inheritance if it doesn't exist:\\
{{{
curl -d command=setUserItem -d xmlItem=inheritance -d serverGroup=MainUsers -d data_action=add -d inheritance_name=AdminTemplate -d usernames="user1;user2" -u crushadmin:pass http://127.0.0.1:8080/
}}}
''(long line, so get it all)''\\
\\
Delete users from an inheritance item:\\
{{{
curl -d command=setUserItem -d xmlItem=inheritance -d serverGroup=MainUsers -d data_action=delete -d inheritance_name=AdminTemplate -d usernames="user1;user2" -u crushadmin:pass http://127.0.0.1:8080/
}}}
''(long line, so get it all)''\\
\\
Delete an entire inheritance:\\
{{{
curl -d command=setUserItem -d xmlItem=inheritance -d serverGroup=MainUsers -d data_action=delete -d inheritance_name=AdminTemplate -u crushadmin:pass http://127.0.0.1:8080/
}}}
''(long line, so get it all)''\\
Run a remote job on the server:\\
{{{
curl -d command=testJobSchedule -d scheduleName=MyFindJob -d async=false -d response_type=all -d myparam1=happy -u crushadmin:pass http://127.0.0.1:8080/
}}}
''(long line, so get it all)''\\
Version Date Modified Size Author Changes ... Change note
27 10-Sep-2018 13:01 6.765 kB Ada Csaba to previous
26 10-Sep-2018 13:00 6.759 kB Ada Csaba to previous | to last
25 07-Nov-2017 10:51 6.485 kB Halmágyi Árpád to previous | to last
24 07-Nov-2017 10:50 6.48 kB Halmágyi Árpád to previous | to last
23 04-Aug-2017 08:05 5.956 kB Ben Spink to previous | to last
22 04-Aug-2017 08:04 5.948 kB Ben Spink to previous | to last
21 28-Jul-2017 14:19 5.801 kB Ada Csaba to previous | to last
« This page (revision-27) was last changed on 10-Sep-2018 13:01 by Ada Csaba
G’day (anonymous guest)

OLD WIKI!!!#

New: CrushFTPv9#

OLD WIKI!!!#


CrushFTP8 | What's New

Referenced by
LeftMenu

JSPWiki