OpDemand Shell

OpDemand Shell-projektet indeholder kommandolinjen klient grænseflade til C2-systemet. Disse python moduler er en del af OpDemand s Command & Control-teknologi (C2).
Open Source
C2-shell-projekt er blevet gjort open source ved OpDemand.
C2 Shell Dokumentation
Før du begynder
- Du skal bruge en aktiv C2-konto. Opret en gratis på https://c2.opdemand.com/
- Instruktioner antage OSX eller Linux (Windows er ikke testet, men bør arbejde)
Installation
Installation bruger standard distutils konvention.
sudo python setup.py installere
Konfiguration
Tilføj din C2 login e-mailadresse til den lokale klient konfiguration.
c2 lokal sæt --email=c2user@opdemand.com
En c2 lokal get vil vise aktuelle konfiguration.
Logge på
Udsted en c2 login, som vil bruge e-mail-adresse konfigureret ovenfor og bede dig om en adgangskode.
bruger @ box: ~ / arbejdsområde / C2-shell $ c2 login
password:
2011-06-07 08: 44: 12.052 - INFO - => POST https://c2core.opdemand.com/session
2011-06-07 08: 44: 13.095 - INFO - GET https://c2core.opdemand.com/template
2011-06-07 09: 21: 21.879 - INFO - <= 200 OK, læsning 1822 bytes af ansøgning / JSON
[# JSON liste over skabeloner
& Nbsp; {
& Nbsp; # Første skabelon
& Nbsp;},
& Nbsp; {
& Nbsp; # Second skabelon
& Nbsp;}
]
2011-06-07 09: 21: 21.881 - INFO - (skabelon / liste) succes i 0.524872s
Find _id værdi den skabelon, du ønsker at installere, og kopiere det til din udklipsholder.
Opret en ny platform
Vælg den ønskede skabelon og udstede en c2 skabelon belastning af skabelonen _id, som vil skabe en ny platform.
bruger @ box: ~ / arbejdsområde / C2-shell $ c2 skabelon belastning --_ id = 6c86dfc5ddfe464199021b8dcaf521a2
2011-06-07 09: 42: 36.711 - INFO - => POST https://c2core.opdemand.com/template/6c86dfc5ddfe464199021b8dcaf521a2/load
2011-06-07 09: 42: 38.606 - INFO - <= 201 Oprettet, læsning 14850 bytes af ansøgning / JSON
{
& Nbsp; # Meget længere JSON repræsentation af skabelonen
}
2011-06-07 09: 42: 38.757 - INFO - (template / belastning) succes i 2.061932s
Liste Platforme
Udsted en c2 platform listen for at se de tilgængelige platforme på din konto.
bruger @ box: ~ / arbejdsområde / C2-shell $ c2 platform liste
2011-06-07 09: 46: 48.327 - INFO - => GET https://c2core.opdemand.com/platform
2011-06-07 09: 46: 48.884 - INFO - <= 200 OK, læsning 566 bytes af ansøgning / JSON
[
& Nbsp; {
& Nbsp; # Din nye platform
& Nbsp;}
]
2011-06-07 09: 46: 48.885 - INFO - (platform / liste) succes i 0.572228s
Kopier _id af denne platform til din Udklipsholder.
Læs platform
Liste operationer viser kun summariske repræsentationer af elementer i en samling. For at se den fulde repræsentation af en platform (én, der indeholder de indlejrede komponenter), skal du udstede en c2 platform læse og give _id:
bruger @ box: ~ / arbejdsområde / C2-shell $ c2 platform læses --_ id = 7bbeacb1082e4810bb1a6643d024496e
2011-06-07 10: 16: 06.050 - INFO - => GET https://c2core.opdemand.com/platform/7bbeacb1082e4810bb1a6643d024496e
2011-06-07 10: 16: 06.984 - INFO - <= 200 OK, læsning 14850 bytes af ansøgning / JSON
{
& Nbsp; # Fuld platform repræsentation
}
2011-06-07 10: 16: 07.152 - INFO - (platform / læst) succes i 1.117754s
Arbejde med JSON svar
Ovenstående platform er for lang til at læse. Heldigvis C2 skallen indeholder et integreret JSON prettifier der gør JSON output fra enhver C2 shell kommando meget lettere at læse.
Simply rør enhver c2 kommando til C2 temmelig:
bruger @ box: ~ / arbejdsområde / C2-shell $ c2 skabelon læse --_ id = 6c86dfc5ddfe464199021b8dcaf521a2 | C2 pretty
2011-06-07 09: 32: 00.646 - INFO - => GET https://c2core.opdemand.com/template/6c86dfc5ddfe464199021b8dcaf521a2
2011-06-07 09: 32: 01.378 - INFO - <= 200 OK, læsning 12022 bytes af ansøgning / JSON
2011-06-07 09: 32: 01.535 - INFO - (template / læst) succes i 0.904613s
tiers.0.name "Netværk Tier"
tiers.0.doctype "tier"
tiers.0._rev "1-5a37d211b276deee536cd72a016af8fa"
... Resten af ​​prettified JSON
Alle C2 kommandoer læses fra standard input og skrive til standard output. Det betyder rå JSON og prettified JSON kan ledes til et andet kommando der bruger UNIX-stil rør. (Fx grep).
Konfigurer platformen
Læs først platform og grep til standard config information:
bruger @ box: ~ / arbejdsområde / C2-shell $ c2 platform læses --_ id = 7bbeacb1082e4810bb1a6643d024496e | C2 pretty | grep config
2011-06-07 10: 26: 29.828 - INFO - => GET https://c2core.opdemand.com/platform/7bbeacb1082e4810bb1a6643d024496e
2011-06-07 10: 26: 30.486 - INFO - <= 200 OK, læsning 14850 bytes af ansøgning / JSON
2011-06-07 10: 26: 30.635 - INFO - (platform / læst) succes i 0.821403s
config.access_network "0.0.0.0/0"
config.image_id "ami-06ad526f"
config.doctype "config"
config._rev "1-38d720a0975e4d377ccbfd3cb7864185"
config.access_port "22"
config.cloud_name "os-øst-1"
config.clone_.parent_id "ceee3724a3674bc096a2a6d2dfde7209"
config.clone_.parent_impl.cls_ "c2core.resolve.Config"
config.admin_network "0.0.0.0/0"
config._id "ceee3724a3674bc096a2a6d2dfde7209"
config.impl.cls_ "c2core.resolve.Config"
config.views.7bbeacb1082e4810bb1a6643d024496e.0.0 "7bbeacb1082e4810bb1a6643d024496e"
config.views.7bbeacb1082e4810bb1a6643d024496e.0.1 "config"
metadata.config_info.access_port "Port lytter på serveren"
metadata.config_info.access_network "Network maske for offentlige brugere"
metadata.config_info.cloud_name "Navn på AWS region"
metadata.config_info.admin_network "Network maske for Admin brugere"
Lad os begrænse al netværksadgang til en vært - 1.1.1.1/32. Dette vil kræve ændring af access_network og admin_network nøgler.
Da config er en indlejret dokument med sin egen _id og _rev, må vi ændre config dokument direkte. For at gøre dette, vi følger RESTful konvention læse repræsentation og rørsystemer den til en opdatering operation:
bruger @ box: ~ / arbejdsområde / C2-shell $ c2 config læse --_ id = ceee3724a3674bc096a2a6d2dfde7209 | c2 config update - --access_network = 1.1.1.1 / 32 --admin_network = 1.1.1.1 / 32
2011-06-07 10: 35: 39.643 - INFO - læsning objekt fra stdin, at ctrl-c pause ...
2011-06-07 10: 35: 39.661 - INFO - => GET https://c2core.opdemand.com/config/ceee3724a3674bc096a2a6d2dfde7209
2011-06-07 10: 35: 40.573 - INFO - <= 200 OK, læsning 692 bytes af ansøgning / JSON
2011-06-07 10: 35: 40.574 - INFO - (config / læst) succes i 0.931527s
2011-06-07 10: 35: 40.603 - INFO - => PUT https://c2core.opdemand.com/config/ceee3724a3674bc096a2a6d2dfde7209
2011-06-07 10: 35: 41.316 - INFO - <= 200 OK, læsning 694 bytes af ansøgning / JSON
{
& Nbsp; "_ id": "ceee3724a3674bc096a2a6d2dfde7209",
& Nbsp; "_ rev": "2-6a1cac4a1851fead776d4184e1218028",
& Nbsp; "access_network": "1.1.1.1/32",
& Nbsp; "access_port": "22",
& Nbsp; "admin_network": "1.1.1.1/32",
& Nbsp; "clone_": {
& Nbsp; "parent_id": "ceee3724a3674bc096a2a6d2dfde7209",
& Nbsp; "parent_impl": {
& Nbsp; "cls_": "c2core.resolve.Config"
& Nbsp;}
& Nbsp;},
& Nbsp; "cloud_name": "os-øst-1",
& Nbsp; "DOCTYPE": "config",
& Nbsp; "image_id": "ami-06ad526f",
& Nbsp; "impl": {
& Nbsp; "cls_": "c2core.resolve.Config"
& Nbsp;},
& nbsp; "synspunkter": {
& Nbsp; "7bbeacb1082e4810bb1a6643d024496e": [
& Nbsp; [
& Nbsp; "7bbeacb1082e4810bb1a6643d024496e",
& Nbsp; "config"
& Nbsp;]
& Nbsp;]
& Nbsp;}
}
2011-06-07 10: 35: 41.317 - INFO - (config / opdatering) succes i 0.730138s
Genlæse platformen konfigurationen for at bekræfte forælder dokument indeholder den opdaterede, indlejret konfiguration:
bruger @ box: ~ / arbejdsområde / C2-shell $ c2 platform læses --_ id = 7bbeacb1082e4810bb1a6643d024496e | C2 pretty | grep config
2011-06-07 10: 37: 11.131 - INFO - => GET https://c2core.opdemand.com/platform/7bbeacb1082e4810bb1a6643d024496e
2011-06-07 10: 37: 11,825 - INFO - <= 200 OK, læsning 14852 bytes af ansøgning / JSON
2011-06-07 10: 37: 11.977 - INFO - (platform / læst) succes i 0.862029s
config.access_network "1.1.1.1/32"
config.image_id "ami-06ad526f"
config.doctype "config"
config._rev "2-6a1cac4a1851fead776d4184e1218028"
config.access_port "22"
config.cloud_name "os-øst-1"
config.clone_.parent_id "ceee3724a3674bc096a2a6d2dfde7209"
config.clone_.parent_impl.cls_ "c2core.resolve.Config"
config.admin_network "1.1.1.1/32"
config._id "ceee3724a3674bc096a2a6d2dfde7209"
config.impl.cls_ "c2core.resolve.Config"
config.views.7bbeacb1082e4810bb1a6643d024496e.0.0 "7bbeacb1082e4810bb1a6643d024496e"
config.views.7bbeacb1082e4810bb1a6643d024496e.0.1 "config"
metadata.config_info.access_port "Port lytter på serveren"
metadata.config_info.access_network "Network maske for offentlige brugere"
metadata.config_info.cloud_name "Navn på AWS region"
metadata.config_info.admin_network "Network maske for Admin brugere"
Start platform
Med vores AWS legitimationsoplysninger på plads, og vores platform i kø op vi er klar til at gå. Udsted en c2 platform start og lad orkestrering begynde:
bruger @ box: ~ / arbejdsområde / C2-shell $ c2 platform starte --_ id = 7bbeacb1082e4810bb1a6643d024496e
2011-06-07 10: 42: 52.849 - INFO - => POST https://c2core.opdemand.com/platform/7bbeacb1082e4810bb1a6643d024496e/start
2011-06-07 10: 42: 53.816 - INFO - <= 202 Accepteret, læsning 0 bytes af ansøgning / JSON
2011-06-07 10: 42: 53.816 - INFO - (platform / start) succes i 0.981219s
For at følge platformens udvikling, læse den fulde platform repræsentation og grep for status for alle indlejrede objekter:
bruger @ box: ~ / arbejdsområde / C2-shell $ c2 platform læses --_ id = 7bbeacb1082e4810bb1a6643d024496e | C2 pretty | grep status
2011-06-07 10: 43: 06.530 - INFO - => GET https://c2core.opdemand.com/platform/7bbeacb1082e4810bb1a6643d024496e
2011-06-07 10: 43: 07.228 - INFO - <= 200 OK, læsning 22227 bytes af ansøgning / JSON
2011-06-07 10: 43: 07.451 - INFO - (platform / læst) succes i 0.935643s
tiers.0.status_.value "bygning"
tiers.0.keypair.status_.detail "nøglepar skabt"
tiers.0.keypair.status_.value "bygget"
tiers.0.sg.status_.detail "regler godkendt med succes"
tiers.0.sg.status_.value "bygget"
tiers.1.status_.value "bygning"
tiers.1.server.status_.detail "venter på at køre, verserer"
tiers.1.server.status_.value "bygning"
status_.detail "start operation udløst"
status_.value "start"
Vi kan se status platformen niveau er begyndt. Re-issue denne kommando flere gange til "meningsmåling" status. Grepping for staten er også nyttigt for at påvise, hvilke komponenter i øjeblikket skifter. Når platformen er gjort, bør status se ud som følger:
bruger @ box: ~ / arbejdsområde / C2-shell $ c2 platform læses --_ id = 7bbeacb1082e4810bb1a6643d024496e | C2 pretty | grep status
2011-06-07 10: 44: 21.015 - INFO - => GET https://c2core.opdemand.com/platform/7bbeacb1082e4810bb1a6643d024496e
2011-06-07 10: 44: 21.736 - INFO - <= 200 OK, læsning 27129 bytes af ansøgning / JSON
2011-06-07 10: 44: 21.988 - INFO - (platform / læst) succes i 0.990599s
tiers.0.status_.detail "startede med succes"
tiers.0.status_.value "kører"
tiers.0.keypair.status_.detail "nøglepar skabt"
tiers.0.keypair.status_.value "kører"
tiers.0.sg.status_.detail "regler godkendt med succes"
tiers.0.sg.status_.value "kører"
tiers.1.status_.detail "startede med succes"
tiers.1.status_.value "kører"
tiers.1.server.status_.detail "lytteren klar på 22 / tcp"
tiers.1.server.status_.value "kører"
status_.detail "start operation succesfulde"
status_.value "kører"
Bemærk et forældre-niveau status som "kører" med serveren lytteren klar den 22. / TCP. Vores platform er klar.
Brug af platformen
Alle platforme offentliggøre oplysninger om, hvordan de bruges. De fleste platforme offentliggør en kombination af:
- URL'er
- Hostname / Port-kombinationer
- logins
- Adgangskoder
Hvis vi læser platformen og grep til udgive vi kan se denne platform offentliggjort en simpel SSH url:
bruger @ box: ~ / arbejdsområde / C2-shell $ c2 platform læses --_ id = 7bbeacb1082e4810bb1a6643d024496e | C2 pretty | grep udgive
2011-06-07 10: 51: 30.694 - INFO - => GET https://c2core.opdemand.com/platform/7bbeacb1082e4810bb1a6643d024496e
2011-06-07 10: 51: 31.764 - INFO - <= 200 OK, læsning 27129 bytes af ansøgning / JSON
2011-06-07 10: 51: 32.038 - INFO - (platform / læst) succes i 1.367026s
tiers.1.server.publish.access_url "ssh: //ubuntu@ec2-50-19-55-84.compute-1.amazonaws.com/"
metadata.publish_info.access_url "URL for adgang til platformen"
En fælles mønster er for platforme til at offentliggøre:
- Admin URL
- Admin Login
- Admin Password
- Adgang URL
Standsning af platform
Når platformen er stoppet, vil dens status se nogenlunde sådan ud:
bruger @ box: ~ / arbejdsområde / C2-shell $ c2 platform læses --_ id = 7bbeacb1082e4810bb1a6643d024496e | C2 pretty | grep status
2011-06-07 10: 57: 51.345 - INFO - => GET https://c2core.opdemand.com/platform/7bbeacb1082e4810bb1a6643d024496e
2011-06-07 10: 57: 52.128 - INFO - <= 200 OK, læsning 27966 bytes af ansøgning / JSON
2011-06-07 10: 57: 52.424 - INFO - (platform / læst) succes i 1.093576s
tiers.0.status_.detail "stoppet med succes"
tiers.0.status_.value "stoppet"
tiers.0.keypair.status_.detail "nøglepar skabt"
tiers.0.keypair.status_.value "stoppet"
tiers.0.sg.status_.detail "regler godkendt med succes"
tiers.0.sg.status_.value "stoppet"
tiers.1.status_.detail "stoppet med succes"
tiers.1.status_.value "stoppet"
tiers.1.server.status_.detail "venter på stoppet, i øjeblikket stoppet"
tiers.1.server.status_.value "stoppet"
status_.detail "stop funktion succesfulde"
status_.value "stoppet"
Platformen stadig eksisterer i skyen, men det er ikke længere pådrage dyre beregne omkostninger (det er dog pådrage ubetydelige omkostninger opbevaring). Du er heller ikke længere at pådrage gebyrer C2 platform. På dette tidspunkt, koster din platform effektivt ingenting.
Platforme kan stoppes og startes uden begrænsninger.
Ødelæg platformen
For rent faktisk at ødelægge alle de cloud-komponenter, der indgår i din platform, skal du udstede en c2 platform ødelægge og giver _id af målet platform:
bruger @ box: ~ / arbejdsområde / C2-shell $ c2 platform ødelægge --_ id = 7bbeacb1082e4810bb1a6643d024496e
2011-06-07 11: 04: 10.667 - INFO - => POST https://c2core.opdemand.com/platform/7bbeacb1082e4810bb1a6643d024496e/destroy
2011-06-07 11: 04: 11.953 - INFO - <= 202 Accepteret, læsning 0 bytes af ansøgning / JSON
2011-06-07 11: 04: 11.953 - INFO - (platform / ødelægge) succes i 1.300462s
Slet platform
Hvis du angiver de platforme, du vil se, at den ødelagte platform stadig eksisterer:
bruger @ box: ~ / arbejdsområde / C2-shell $ c2 platform liste | C2 pretty
2011-06-07 11: 12: 02.771 - INFO - => GET https://c2core.opdemand.com/platform
2011-06-07 11: 12: 03.149 - INFO - <= 200 OK, læsning 1577 bytes af ansøgning / JSON
2011-06-07 11: 12: 03.150 - INFO - (platform / liste) succes i 0.394324s
0.views.7bbeacb1082e4810bb1a6643d024496e.0.0 "7bbeacb1082e4810bb1a6643d024496e"
0.time_.disconnect.date_ "1307466249,487580"
0.time_.stop.date_ "1307465858,607597"
0.time_.start.date_ "1307465019,767619"
0.time_.build.date_ "1307465019,475195"
0.time_.destroy.date_ "1307466249,487347"
0.time_.connect.date_ "1307466240,220381"
0.status_.detail "ødelægge operation succesfulde"
0.status_.value "ødelagt"
0.doctype "platform"
0._rev "7-38fe44c5a900894adf48f4a416c94338"
0.template.cls_ "lib.platform.vanilla.natty.UbuntuNattyPlatform"
0._id "7bbeacb1082e4810bb1a6643d024496e"
0.state.running falsk
0.state.transitioning falsk
0.state.built falsk
0.impl.cls_ "lib.platform.vanilla.natty.UbuntuNattyPlatform"
0.interval_.destroy 9,3936290740966797
0.interval_.stop 33,600441932678223
0.interval_.build 57,54404091835022
0.interval_.start 57,836580991744995
Fra interval kan man se det tog:
- 58 sekunder at starte denne platform
- 33 sekunder for at stoppe det
- 9 sekunder at ødelægge det
Du kan altid genstarte en ødelagt platform og har det genopbygge cloud komponenter igen. Men for at fuldføre slette platformen og dens indlejrede dokumenter, du skal udstede en c2 platform slettes:
bruger @ box: ~ / arbejdsområde / C2-shell $ c2 platform slette --_ id = 7bbeacb1082e4810bb1a6643d024496e
2011-06-07 11: 15: 45.235 - INFO - => Slet https://c2core.opdemand.com/platform/7bbeacb1082e4810bb1a6643d024496e
2011-06-07 11: 15: 46.474 - INFO - <= 204 Nej Indhold, læsning 0 bytes af ansøgning / JSON
2011-06-07 11: 15: 46.474 - INFO - (platform / slet) succes i 1.252582s
For at bekræfte, kan vi se vores platform listen er nu tom:
bruger @ box: ~ / arbejdsområde / C2-shell $ c2 platform liste
2011-06-07 11: 15: 51.890 - INFO - => GET https://c2core.opdemand.com/platform
2011-06-07 11: 15: 52.296 - INFO - <= 200 OK, læsning 2 bytes ansøgning / JSON
2011-06-07 11: 15: 52.297 - INFO - (platform / liste) succes i 0.423616s
Logger ud
Ved at udstede en c2 info kan vi se status for vores session:
bruger @ box: ~ / arbejdsområde / C2-shell $ c2 info
2011-06-07 11: 17: 11.656 - INFO - => GET https://c2core.opdemand.com/session/73c2e9b49d01c695fb6c74927b8eb0eee5cdc82c2064cd728a8033eb83ea5b95
2011-06-07 11: 17: 12.134 - INFO - <= 200 OK, læsning 4082 bytes af ansøgning / JSON
{
& Nbsp; "konto": "C2-opdemand",
& Nbsp; "email": "gabriel@opdemand.com",
& Nbsp; "expires_at": "Fredag ​​10 juni, 2011 08:44",
& Nbsp; "session_id": "73c2e9b49d01c695fb6c74927b8eb0eee5cdc82c2064cd728a8033eb83ea5b95"
}
2011-06-07 11: 17: 12.138 - INFO - (info) succes i 0.497018s
Logge ud er simpelthen c2 logout:
bruger @ box: ~ / arbejdsområde / C2-shell $ c2 logout
2011-06-07 11: 17: 44.903 - INFO - => Slet https://c2core.opdemand.com/session/73c2e9b49d01c695fb6c74927b8eb0eee5cdc82c2064cd728a8033eb83ea5b95
2011-06-07 11: 17: 45.330 - INFO - <= 204 Nej Indhold, læsning 0 bytes af ansøgning / JSON
2011-06-07 11: 17: 45.330 - INFO - (Log af) succes i 0.443405s
bruger @ box: ~ / arbejdsområde / C2-shell $ c2 info
2011-06-07 11: 17: 49.025 - INFO - (info) succes i 0.000376s
Om C2
OpDemand s Command & Control Technology (C2) automatiserer implementering og administration af cloud computing-infrastruktur. Med en grænseflade så simpelt som "start, stop, klon og ødelægge," C2 giver dig kommandoen over din sky

Krav :.

• Python