[{"data":1,"prerenderedAt":321},["ShallowReactive",2],{"\u002Fdocs\u002Fguides\u002Fsharing":3},{"id":4,"title":5,"body":6,"description":313,"extension":314,"meta":315,"navigation":316,"path":317,"seo":318,"stem":319,"__hash__":320},"docs\u002Fdocs\u002Fguides\u002Fsharing.md","Sharing",{"type":7,"value":8,"toc":304},"minimark",[9,13,17,22,25,171,174,178,202,222,233,237,252,256,268,272],[10,11,5],"h1",{"id":12},"sharing",[14,15,16],"p",{},"You can share a device with other users on the same NetIgnite server: let your family power on the\nmedia PC, or let a colleague reboot a server. You stay the owner, and commands still go through\nyour agent.",[18,19,21],"h2",{"id":20},"roles","Roles",[14,23,24],{},"Each share has a role:",[26,27,28,49],"table",{},[29,30,31],"thead",{},[32,33,34,37,40,43,46],"tr",{},[35,36],"th",{},[35,38,39],{},"Owner",[35,41,42],{},"Manager",[35,44,45],{},"Operator",[35,47,48],{},"Viewer",[50,51,52,71,84,106,119,132,145,158],"tbody",{},[32,53,54,62,65,67,69],{},[55,56,57,58],"td",{},"See the device and its status, ",[59,60,61],"strong",{},"Check now",[55,63,64],{},"✓",[55,66,64],{},[55,68,64],{},[55,70,64],{},[32,72,73,76,78,80,82],{},[55,74,75],{},"Add it to their favorites",[55,77,64],{},[55,79,64],{},[55,81,64],{},[55,83,64],{},[32,85,86,98,100,102,104],{},[55,87,88,91,92,91,95],{},[59,89,90],{},"Power on",", ",[59,93,94],{},"Shut down",[59,96,97],{},"Reboot",[55,99,64],{},[55,101,64],{},[55,103,64],{},[55,105],{},[32,107,108,111,113,115,117],{},[55,109,110],{},"Edit name, type, description, MAC address, port and status check",[55,112,64],{},[55,114,64],{},[55,116],{},[55,118],{},[32,120,121,124,126,128,130],{},[55,122,123],{},"Choose the agent and the Linux agent on the device",[55,125,64],{},[55,127],{},[55,129],{},[55,131],{},[32,133,134,137,139,141,143],{},[55,135,136],{},"Set up the SSH login",[55,138,64],{},[55,140],{},[55,142],{},[55,144],{},[32,146,147,150,152,154,156],{},[55,148,149],{},"Share the device, change and remove shares",[55,151,64],{},[55,153],{},[55,155],{},[55,157],{},[32,159,160,163,165,167,169],{},[55,161,162],{},"Delete the device",[55,164,64],{},[55,166],{},[55,168],{},[55,170],{},[14,172,173],{},"Agents are never shared. Users you share a device with see the name and status of its agents, but\ncan't open them, use them for their own devices or see their credentials. They never see the\ndevice's SSH login either.",[18,175,177],{"id":176},"sharing-a-device","Sharing a device",[179,180,181,188,195],"ol",{},[182,183,184,185,187],"li",{},"Open the device and its ",[59,186,5],{}," tab. Only the owner has it.",[182,189,190,191,194],{},"Enter the other user's ",[59,192,193],{},"username or email address"," and choose a role.",[182,196,197,198,201],{},"Click ",[59,199,200],{},"Share",".",[14,203,204,205,208,209,213,214,217,218,221],{},"The user must already have an account on the server; NetIgnite doesn't send invitations. The device\nthen appears in their ",[59,206,207],{},"Devices"," list with their role and ",[210,211,212],"em",{},"by"," your name, and on their\n",[59,215,216],{},"Overview"," as ",[210,219,220],{},"shared by"," you.",[14,223,224,225,228,229,232],{},"Under ",[59,226,227],{},"People with access",", change someone's role with the role menu, or remove their access with\nthe ",[59,230,231],{},"×"," button. Removing a share also removes the device from their favorites.",[18,234,236],{"id":235},"leaving-a-shared-device","Leaving a shared device",[14,238,239,240,243,244,247,248,251],{},"On a device someone shared with you, the ",[59,241,242],{},"General"," tab shows your role and a ",[59,245,246],{},"Leave device","\nsection. ",[59,249,250],{},"Leave"," removes the device from your account until the owner shares it again.",[18,253,255],{"id":254},"when-the-owner-deletes-things","When the owner deletes things",[257,258,259,262,265],"ul",{},[182,260,261],{},"Deleting the device removes all its shares.",[182,263,264],{},"Deleting or changing the device's agent affects everyone: if the agent is gone, nobody can wake\nthe device until the owner chooses another one.",[182,266,267],{},"Deleting the owner's account deletes their devices, and with them all shares.",[18,269,271],{"id":270},"with-the-api","With the API",[14,273,274,275,280,281,91,285,288,289,292,293,296,297,300,301,201],{},"The owner manages shares with the ",[276,277,279],"a",{"href":278},"\u002Fdocs\u002Freference\u002Fapi#sharing","REST API",":\n",[282,283,284],"code",{},"GET \u002Fapi\u002Fv1\u002Fdevices\u002F\u003Cid>\u002Fshares",[282,286,287],{},"POST"," with ",[282,290,291],{},"{ \"user\": \"\u003Cusername or email>\", \"role\": \"operator\" }",",\n",[282,294,295],{},"PUT \u002Fapi\u002Fv1\u002Fdevices\u002F\u003Cid>\u002Fshares\u002F\u003Cuser-id>"," with a new role, and ",[282,298,299],{},"DELETE"," to remove a share. A user\nleaves a device with ",[282,302,303],{},"DELETE \u002Fapi\u002Fv1\u002Fdevices\u002F\u003Cid>\u002Fshares\u002F\u003Ctheir user id>",{"title":305,"searchDepth":306,"depth":306,"links":307},"",2,[308,309,310,311,312],{"id":20,"depth":306,"text":21},{"id":176,"depth":306,"text":177},{"id":235,"depth":306,"text":236},{"id":254,"depth":306,"text":255},{"id":270,"depth":306,"text":271},"Share NetIgnite devices with other users as viewer, operator or manager, and what each role can do.","md",{},{"title":5},"\u002Fdocs\u002Fguides\u002Fsharing",{"title":5,"description":313},"docs\u002Fguides\u002Fsharing","hZ0Pxb7Tygx2hYoX4aKUZSoke9546uThCUwtbRuZ-iY",1792614952937]